> For the complete documentation index, see [llms.txt](https://docs.optis.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.optis.me/product-options/20-option-types/swatch-and-button/swatch.md).

# Swatch

✨ [Demo store](https://optis-product-options-variant.myshopify.com/products/swatch?variant=51025989075222)

### 1. How Does the Swatch Display?

The Swatch option allows customers to select choices visually using images, colors, or labels instead of traditional dropdowns or checkboxes. This enhances the shopping experience, especially when product customization involves selecting colors, styles, or materials.

Example of how it appears on a product page:

* Customers can click on color blocks or image thumbnails to select options such as T-shirt color, fabric, etc.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F7BRB03P4BGUQV9pCp4nH%2FScreenshot%20-%202026-01-13T140048.698.png?alt=media&amp;token=9d86e87a-7b38-4521-ab1d-53d2e5f3b20c" alt=""><figcaption></figcaption></figure>

### 2. How to Create a Swatch

**Step 1: Add a New Option**

* Open **1. Add options**, click **Add option**, tick **Swatch** under **Swatch** on the **New options** tab, then click **Add options**.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FoIXTMFhfDLgTfqfnHEVI%2F31.png?alt=media&amp;token=3101db53-36ed-4b23-8ea9-d1a361ed22da" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdu41GpoydhSlZCrwNUtUiH_GKsbXVqVsab8DvNA48jjahqfXw2Njkg4YoWPAbZfgHbIKSQYU0ucEVSSGJnIWK_sEcakgwzIPDXD-_8bewi6JoiTL7xk9XrOx1cEXa_JLZQzUvarg?key=DC83dM0yOWsDjpoRFQoUWeuE" alt=""><figcaption></figcaption></figure>

**Step 2: Add information to the Swatch**

* Enter an option name (e.g., "Choose Color", "Select Fabric", "Pick a Finish")
* Add option values (e.g., Red, Blue, Black, White)
* Show option value label if needed
* Tick on “Required field” if you want customers must choose the option before checking out.
* Tick on "Hide option label” if you don’t want to show the option name above the option values.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fiu0Qfpl9Z3TZqvn9TGBQ%2F32.png?alt=media&amp;token=97485db2-9734-46ef-a031-e0581ba0f0dd" alt=""><figcaption></figcaption></figure>

* For each value, you can:
  * Choose a color swatch (solid color)

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FLUsaa7t6uEz9oHacU5r8%2F33.png?alt=media&amp;token=b0a31800-9b33-4213-9885-97184ca12688" alt=""><figcaption></figcaption></figure>

* Upload an image swatch (custom image)

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FnZ1WV5zGRxHkyWeSUtFY%2F34.png?alt=media&amp;token=d6f5b19e-8846-498c-a095-33fa600b0372" alt=""><figcaption></figcaption></figure>

Other features:

* Price add-on > Extra fee – [What is it & How to Use](https://www.youtube.com/watch?v=5Bq4t0IrVEU)
* Price add-on > Upsell product – [What is it & How to Use](/product-options/advanced-setup/how-to-use-upsell-product-link-stock-and-price-of-shopify-variant-to-option-value.md)
* SKU – [What is it & How to Use](https://www.shopify.com/ca/retail/what-is-a-sku-number)
* Quantity – [What is it & How to Use](/product-options/advanced-setup/how-to-use-the-quantity-feature-for-options.md)

**Step 3: Advanced Settings (If Needed)**

{% hint style="success" %}
**Visibility:** Enable visibility (conditional logic) if you want the Swatch to show/hide only when a customer selects a specific option from another field. [How to set up Conditional logic?](/product-options/advanced-setup/other-popular-features/how-to-set-up-conditional-logics.md)
{% endhint %}

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FRVVJTu68ClESmHxinAXz%2F4.png?alt=media&amp;token=4ef5830f-56a4-4cbd-94ba-e94e8db2bdda" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Help text:** Add a short description to explain the purpose of the Swatch option. It can be displayed as Tooltips or Content (Below/Beside the option title, Below the option).
{% endhint %}

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FTTd0Z02tyJJgBCQqIle2%2F9.png?alt=media&amp;token=3f4c410a-1b59-48ea-b53a-d606ebed96fd" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Default value:** Pre-select the Swatch options every time the customer goes to the site. It can save time for customers by providing common or expected choices.
{% endhint %}

Example: You want the option value “Black” on Color to be selected automatically when customers enter the product page.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2F25xfk9TniaMuaNTbOcT9%2F35.png?alt=media&amp;token=71accb5e-780b-4346-b62b-103e3b851ca1" alt=""><figcaption></figcaption></figure>

How it looks like in your storefront:

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FwLW2Tnirjy6i0Un6Ra2p%2F36.png?alt=media&amp;token=b2e4c19c-3e32-4f70-9c31-8dd89cf43810" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Quantity:** Lets customers choose how many units of each value they want. Turn on the **Quantity** column for the values that need it (use **Columns** in the **Option values** table), then set **Min quantity** and **Max quantity** to limit the total quantity across all values. Learn more in [How to use the Quantity feature](/product-options/advanced-setup/how-to-use-the-quantity-feature-for-options.md).
{% endhint %}

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FdU4vmT697Hzw2PJUTw0g%2F12.png?alt=media&amp;token=7c1647cc-be91-4bc0-997b-62a9062960a7" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Live Mockup:** Allows customers to preview their selections in real time. You can **customize** the preview to help customers visualize how their selected options will look on the final product. [Product Personalizer - Live Mockup Settings](/product-options/advanced-setup/other-popular-features/product-personalizer-live-mockup-settings.md)
{% endhint %}

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FYqgYKLOJ417HCsS9E8pY%2F12.png?alt=media&amp;token=847e906d-cce5-4858-b0a4-95ee70380035" alt=""><figcaption></figcaption></figure>

**Step 4: Save and Test**

* Click Save to apply the settings.
* Visit the product page on your store to check if the Swatch option works correctly.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FFzxMNV9rzyA07GgUFdvX%2F37.png?alt=media&amp;token=85d50f9c-5b7b-4c3a-9194-547ce8b70059" alt=""><figcaption></figcaption></figure>

### 3. Real-World Applications of Swatch

* Color selection for apparel
* Material choice for furniture
* Pattern/texture selection for home décor
* Visual product personalization (e.g., monogram styles)

### 4. Key Features of Swatch

* Allows users to select **one option** from a predefined list.
* Ensures clear and exclusive selections.
* Ideal for displaying multiple option values.
* Helps save space and maintain a **clean, organized design**.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfaumUqLADSmK0Dz5vBSECq1h2pylBaPpzn9k-QoYV4q6UQOJVxZEVuQXKIK4_JDF7AbJpb8xzqxOMlGy_v0xGXi2m7WoX1Iu30tn_aJjjIFSD5iKr6t3t9wdc-y60jq-W5KhpMNQ?key=DC83dM0yOWsDjpoRFQoUWeuE" alt=""><figcaption></figcaption></figure>
