> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://customix.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Image Swatch Personalization

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 value picker like Additional Swatch.

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](https://lh3.googleusercontent.com/d/11kZ3o_Of4eJQJMO-FUfudY9kBtKG6ODP=w1000)

![Add option button in the option set editor](https://lh3.googleusercontent.com/d/1HVl-gC9spEsUoXHziKEVBbSBubkadAyq=w1000)

![Add option menu with Image swatch selected under Choice list](https://lh3.googleusercontent.com/d/14yJpjIZOplql-3EeZF_31ilHFWc-q_LS=w1000)

# 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](https://lh3.googleusercontent.com/d/1J3hO5Q13qH4bR6RMhnrMUoyCSavOSQhm=w1000)

Clicking **Import from folder** opens the Assets library. Unlike Additional Swatch, which reads a folder's sub-folders, 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](https://lh3.googleusercontent.com/d/17z1BmqwH0ZdfvB2fzceYM4U6zuHVYUdI=w1000)

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](https://lh3.googleusercontent.com/d/1nupDTzpLAWs3d3LH4dDkpViYL-3C527k=w1000)

* **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](https://lh3.googleusercontent.com/d/1-oBQJrw5AlkqYG58nEqqaQ9jnLhIHnYs=w1000)

![Option set preview showing the Dropdown display style as a select menu](https://lh3.googleusercontent.com/d/1m7kZtuZflod2Rk3ESw-wM-PaUtP69sFo=w1000)

# How it renders on the canvas

This is what sets Image swatch apart from Additional Swatch: 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](https://lh3.googleusercontent.com/d/1UDHyn5ookPa31Ebcrc-5sD0yIrsSpsIT=w1000)

# 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 Additional Swatch's values do. See the Conditional Option Sets guide if you want to set that up.

> 📌 Don't forget to click **Save** once you're happy with the setup, and make sure the option set's status is **Active** (not Draft). Customers won't see the Image swatch option on your storefront until both are done.