Handsome documentation

Feature guides

Colour swatches

Show product options as buttons, dropdowns, colour circles or small product photos, on the product page, product cards and quick add.

Product cards with image swatches and size options
Image swatches from variant photos, with size options under each card (Tribe preset).

Choose a style per option

Go to Theme settings โ†’ Product variants.

  1. Default variant option style applies to every option.
  2. Under Style by option name, override up to three options by name. For example:
Variant option nameStyle
ColorImage swatch
SizeSimple buttons
FlavourDropdown

The name must match the option name on your products (Color, Colour, Size and so on).

Where swatch colours and images come from

For Color swatch and Image swatch, the theme uses the first of these it finds for each value:

  1. The swatch image set on the option value in the product's admin page.
  2. The swatch colour set on the option value.
  3. The variant's own photo, so each swatch shows the product in that colour.
  4. The value's name read as a colour: simple names like Black, Navy or Red work with no setup.
The easiest setup

Use Image swatch and give every variant its own photo. Swatches then show the real product in each colour, with nothing else to set up.

On product cards

Under Theme settings โ†’ Product card โ†’ Swatches and sizes you can show swatches and size options on every card, choose their size and shape, and limit how many show before a +3 link.

Colour filters

Collection filters can show colours as swatches too. See Collection filters.