Custom color swatches

Palo Alto will display swatches for color variants in collection filtering and the product form on product pages.

Palo Alto will detect if your variant label is color or colour and automatically display swatches

Customize the trigger words

To customize the trigger words which activate swatches, use the theme content (edit default theme content) and add or modify the values:

You can add more trigger words that will help use swatches for other options.

The result is the same and you can use different custom swatches as well.


Palo Alto can easily detect simple color names and convert them to swatches. There are a total of 140 color names Palo Alto 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: color names list


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:

To find additional HEX color codes, visit:

Add custom images to the assets folder

With Palo Alto, you can upload your own custom swatch images and display them on product and collection pages.

How to:

  • Create a small square image (60x60 or 100x100 for best results)

  • Upload to the assets folder

  • Modify swatches.json to include your color name and image

Disabling swatches

Swatches can be toggled on and off in the theme settings under swatches:

Last updated