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
Provide your swatch setup within Tolstoy
Product Metafield - for users who store color information in product metafields
Product Metafield - for users who store color information in product metafields
Go to Settings -> Variant Styling
Select an example product in Tolstoy
This is for Tolstoy to use to pull up example metafield data.
Identify Your Variant Name in Shopify and add To Tolstoy
In your Shopify product settings, locate the name of the variant you use for colors (e.g., "color", "shade", "hue").
This name is case-sensitive, so make sure to copy it exactly as it appears in Shopify.
Paste this into Tolstoy where it says “Variant Name”
4. Locate Your Metafields Information in Shopify
Go to your Shopify store settings.
Navigate to "Settings" > "Custom data" > "Products".
Find the Metafield that contains your color swatch information.
Note down the namespace and key of your color swatch Metafield the namespace is the first part before the period, and the key is the second part)
Paste this into Tolstoy where it says “Metafield namespace” and “Metafield key”.
5. Map Metafields Data in Tolstoy
Once you’ve provided your Metafield namespace key you will be able to search for the fields within the metafield. Press “Search for fields”
Select the appropriate JSON fields for:
Variant ID
Variant Color (if applicable)
Variant Image (if applicable)
Follow the JSON path to select the correct fields (e.g., color_swatches > [variant] > variant_id).
Please note you have to provide at least either variant color or variant image url, but can provide both if you have some variants that use colors and some with images
Variant Metafield - for users who store color information in product metafields
Variant Metafield - for users who store color information in product metafields
Identify Your Variant Name in Shopify and add To Tolstoy
In your Shopify product settings, locate the name of the variant you use for colors (e.g., "color", "shade", "hue").
This name is case-sensitive, so make sure to copy it exactly as it appears in Shopify.
Paste this into Tolstoy where it says “Variant Name”
Locate Your Metafields Information in Shopify
Go to your Shopify store settings.
Navigate to "Settings" > "Custom data" > "Products variant metafields".
You can navigate to this page by going to https://admin.shopify.com/store/y/settings/custom_data/productvariant/metafields
Paste this into Tolstoy where it says “Metafield namespace” and “Metafield key”.
Store your color swatches using another method? Let us know your setup at danielle@gotolstoy.com 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
To add swatches to your spotlight, toggle on the button in your Spotlight project settings under Design
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.
Troubleshooting
If your color swatches are not appearing correctly:
Double-check that your variant name matches exactly with what's in Shopify.
Verify that your Metafields namespace and key are correct.
Ensure that the JSON paths for variant ID, color, and image (if used) are accurately mapped.
If you continue to experience issues, don't hesitate to reach out to Tolstoy support for assistance.