Skip to main content
Product Variant Color Swatches
Danielle Harris avatar
Written by Danielle Harris
Updated over 2 months ago

Introduction

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

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

Color Swatches - for users who store color information in metafields

Store your color swatches using another method? Let us know your setup at danielle@gotolstoy.com so we can increase our support.

  1. Select an example product in Tolstoy

  • This is for Tolstoy to use to pull up example metafield data.

2. 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”

2. 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”.

4. 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

  1. Choose Swatch Shape

    • Select whether you want your color swatches to appear as circles or squares.

  2. 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

  1. To add swatches to your spotlight, toggle on the button in your Spotlight project settings under Design

  2. 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.

Did this answer your question?