Skip to main content

Product Variant Color Swatches in the New Platform

This guide will walk you through the process of adding color swatches to your Tolstoy account.

Written by Joan Anonuevo
Updated over a week ago

Color swatches allow customers to easily view and select different color variants of your products within the Tolstoy interface, including in the in-feed PDP and on the spotlight.

In-feed PDP

Swatches on spotlight

Prerequisites

  • You have access to your Shopify store settings.

  • You may need assistance from a developer if you're not familiar with Metafields. Or, please reach out to support@gotolstoy.com for support from our team.

Set up

  1. Provide your swatch setup within Tolstoy

Product Metafield - for users who store color information in product metafields

Variant Metafield - for users who store color information in product metafields

Store your color swatches using another method? Let us know your setup so we can increase our support.

2. Choose Swatch Shape

  • After you've set up the source for your swatch colors, select whether you want your color swatches to appear as circles or squares.

3. Save Your Settings

  • After configuring all the necessary fields, save your settings in Tolstoy.
    ​

Integrating in app

In-feed PDP

  • Once metafields are properly connected, they will automatically appear as swatches in your in-feed PDP

Swatches on spotlight

Step 1: Set Up Color Swatches in Your Spotlight Project

  1. Go to Publish.

  2. Open your Spotlight project.

  3. Click the Design tab.

  4. Under Widget, locate Color Swatch on Video.

  5. Click the Set Up button next to it.

You will be redirected to Product Settings to configure your swatches.

The color swatches will only show on video cards tagged with products with variants. Make sure to tag your variant in your video if you're missing swatches.

Step 2: Configure Variant Styling in Product Settings

In Product Settings, scroll to the Variant Styling section and configure the following fields:

  • Select Swatch Method
    Choose how swatches are pulled (for example, Shopify Product Metafields).

  • Variant Name
    Enter the product option name (e.g., Color).

  • Metafield Namespace
    Enter your Shopify metafield namespace (e.g., custom).

  • Metafield Key
    Enter your metafield key (e.g., tolstoy_swatch).

  • Example Product
    Select a product with variants to test your configuration.

  • Variant ID
    Map the Variant ID field.

  • Variant Color
    Map the variant color field.

  • Variant Image URL
    Map the variant image field (if using image-based swatches).

  • Preference Setting
    If both hex color and image data exist, choose which to prioritize.

  • Swatch Shape
    Select Circle or Square.

  • Size Selection
    Choose how size variants should be displayed:

    • Dropdown – Sizes appear in a collapsible dropdown menu.

    • Buttons – Sizes appear as clickable buttons.

All swatches and size selections will appear on video cards tagged with products that include variants.

Important Notes & Troubleshooting

  • Swatches only appear on video cards tagged with products that have variants.

  • Ensure the product includes active variants (e.g., multiple colors or sizes).

  • Make sure the correct product is tagged in your video.

  • Confirm the Variant Name matches exactly what is set in Shopify (for example, Color).

  • Verify your Metafield Namespace and Metafield Key are correct.

  • Ensure the Variant ID, Color, and Image fields are properly mapped in Variant Styling.

If swatches still do not appear after reviewing the above, please contact Tolstoy Support for assistance.

Did this answer your question?