> ## 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).

# Additional Swatch Personalization

The **Additional Swatch** option lets customers pick from a set of named choices, where each choice comes from a folder in your Assets library instead of individual image files. It's the option to reach for when you need a simple picker, like a yes/no toggle, a size guide, or a style selector, that drives what else shows up on the product through **Condition**, rather than a swatch that changes the artwork on the canvas directly.

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

![Option sets in the sidebar navigation](https://lh3.googleusercontent.com/d/13ElXne40P4wHkz_y7qfjLQFUXLmVZoGH=w1000)

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

![Add option menu with Additional swatch selected under Choice list](https://lh3.googleusercontent.com/d/1j1368aMMtQ_2mErFJLlgZ28D6PWlxCFh=w1000)

# Content

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

* **Label**: the field name shown above the picker, defaults to "Additional swatch"
* **Values**: click **Select folder** to link a folder from your Assets library, each of that folder's sub-folders becomes one selectable value, named after the sub-folder

![Content panel with Label field, Values section, and Select folder button](https://lh3.googleusercontent.com/d/1HfyS53wMfuP3K2dpmXjfb0v1w49SC1LH=w1000)

Clicking **Select folder** opens the Assets library so you can browse to and check the folder you want to link. Only a folder that itself contains sub-folders produces any values, a folder of loose image files (like most existing Assets folders) won't work here since Additional Swatch reads sub-folders, not files.

![Assets library folder browser inside the Select folder dialog](https://lh3.googleusercontent.com/d/192ymg2nPgt9xkzIp6DbMsw_Nm5Jo90sP=w1000)

Once linked, each value appears in the Content panel and the button changes to **Change folder** if you want to swap the source later. Re-linking the same or a different folder refreshes the values to match its current sub-folders.

![Content panel after linking a folder with two sub-folders, showing No and Yes as values](https://lh3.googleusercontent.com/d/1R5wAmiJbc79eKZc3puNgcVAFWR1GSEug=w1000)

* **Display style**: choose **Thumbnail** to show each value as an image tile, **Button** to show them as buttons, or **Dropdown** to show them as a select menu

![Option set preview showing the Button display style with No and Yes as buttons](https://lh3.googleusercontent.com/d/1eoqrv7FlLqitm0OmouTCBnwkfmUB_2dp=w1000)

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

# Using it with Condition

Additional Swatch has no Colors, Fonts, or Transform settings of its own, its whole purpose is to feed a choice into **Condition** on other options. A common setup is a yes/no toggle that shows or hides another option, for example an **Upload photo** option that should only appear once the customer confirms they want to upload something.

To wire that up, open the option you want to control (like **Upload photo**), expand its **Condition** section, click **Edit**, then **Add condition**. The condition picker lists every value from your Additional Swatch options right alongside Shopify variant options like Color and Size, so you can pick the exact value (like **Yes**) to match against.

![Edit condition dialog with the option picker showing Additional swatch values alongside Shopify variant options](https://lh3.googleusercontent.com/d/14FbfxNRL52OE1VDVKMSBqTG8X_Ub9qb2=w1000)

With the condition saved, the controlled option disappears from the preview until the customer picks the matching value, then it reappears automatically.

![Option set preview with Upload photo hidden because Additional swatch has no value selected yet](https://lh3.googleusercontent.com/d/177rf4WahNlkSwArjKzs7-jm-7nlKvN57=w1000)

![Option set preview with Upload photo visible after selecting Yes in Additional swatch](https://lh3.googleusercontent.com/d/1nJw0Fur4iL1XRkKWHd_KgzPxa72acqyS=w1000)

Like most option types, Additional Swatch also supports its own conditions, so you can show or hide it based on another selection elsewhere in the option set. 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 Additional Swatch option on your storefront until both are done.