Color swatches

Add visually appealing color and color swatches

Story can display color variants as swatches on product pages and collections:

Color swatches can be used when product variants have colors

Collection filtering helps customers find items by color:

Product grid listing on Collection page

How to use

Manage color swatch settings under the Theme settings -> Product grid. By default, swatches are enabled:

When unchecked or disabled, the swatches turn into variant option boxes:

Customize the trigger words

To customize the trigger words which activate swatches, use the Language Editor (Edit languages) and add or modify the values:

Open the Languge Editor (Edit languages)
Change the trigger words under General -> Swatches

Trigger words are the variant label names in your product setup, these are matched with the Language editor:

Tip: Products that have two color variants like "Top" and "Bottom" can be added to this list.

Swatch color names

Story can easily detect simple color names and convert them to swatches. There are a total of 140 color names Pipeline can detect, all other more complex names will be represented by a default grey color swatch. You can upload your own custom color names and graphics as described below. Here is a full list of color names that will automatically be converted to swatches:

Click to view list of supported default color names

Swatches are generated using the variant color names. If you have simple color names or color names that are listed in the above list, Story will display that color on the product page as a swatch:

Swatches are generated using these variant color names

If your variant color name is not listed in the above list, a default grey color swatch will be used:

Customizing

If your products have color names other than the listed colors in the Color names list, you can add your own color names and values or upload images to the Assets folder:

Add custom color names and values to swatches.json

Use the swatches.json file located in the Assets folder to add your own custom names and HEX color values:

For example, to change the color displayed for Ink, we can change the HEX value of #696969:

    {
      "ink": "#696969"
    },

Change to a darker black:

    {
      "ink": "#323232"
    },

To find additional HEX color codes, visit: https://colorhunt.co

Adding custom swatch images

With Story, you can add your custom images to represent swatch colors. We have a full tutorial on how to add custom images and display them as swatches on our Pipeline theme support page: https://pipeline.groupthought.com/products/color-swatches#add-custom-images-to-the-assets-folder

The process is exactly the same when using with Story theme.

Learn how to add custom images:

There is a 3-minuite video with full walk-through on how to add custom images

Last updated