The Image swatch option lets customers pick from a set of named images, where each choice actually swaps the artwork shown on the canvas. It's the option to reach for when a design has real visual variants, like different colorways of the same illustration, rather than a plain choice picker like a Choice list.

To add it, go to Option sets in the sidebar, open the option set for your product, click Add option, choose Image swatch under Choice list, then click Add.

Option sets in the sidebar navigation
Add option button in the option set editor
Add option menu with Image swatch selected under Choice list

Content

The Content section controls the label, the images customers pick from, and how they're displayed.

  • Label: the field name shown above the picker, defaults to "Image swatch"
  • Default image: an independent fallback image, picked from any asset in your library, not necessarily one of the swatch values below
  • Image set: empty at first, with Add image (upload or pick a single file) and Import from folder (bulk-add every file already in an Assets folder) to populate it
Content panel with Label, Default image, and empty Image set showing Add image and Import from folder buttons

Clicking Import from folder opens the Assets library. Image swatch reads a folder's own image files directly, so a flat folder like "Choose Color" works as-is. Tick the folder's checkbox in the Folders list (don't navigate into it, clicking a folder's name opens it instead of selecting it) and click Done.

Images dialog with the Choose Color folder's checkbox ticked in the Folders list

Every file in that folder becomes one value in the Image set, named after its filename, with the first one set as Default automatically.

Content panel after importing, showing Black, Blue, Brown, Green, Navy, and Pink in the Image set with Black marked Default
  • Display style: choose Thumbnail to show each value as an image tile, Button to show them as text buttons, or Dropdown to show them as a select menu
Option set preview showing the Button display style with each color as a labeled button
Option set preview showing the Dropdown display style as a select menu

How it renders on the canvas

This is what sets Image swatch apart from a Choice list: picking a value doesn't just record a choice, it redraws the option's own canvas layer with that image. Selecting Pink immediately swaps the artwork on the product mockup to the pink version.

Canvas and Option set preview after selecting Pink, showing the pink cat artwork rendered on the shirt

Condition

Like most option types, Image swatch supports its own conditions, so you can show or hide it based on another selection elsewhere in the option set. Because each value has its own name (Black, Blue, Brown...), those names also show up as separate entries in other options' Condition pickers, the same way a Choice list's choices do. See the Conditional Option Sets guide if you want to set that up.

Updated on: 17/07/2026