> 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/swatch/variant-display/swatch-card.md).

# Swatch card

{% hint style="success" %}
**Available on:** Product page only
{% endhint %}

✨Demo product: [Swatch card](https://optis-color-swatch-variant.myshopify.com/products/bucket-hat-1?variant=45188750508169) (password: 1)

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-a3d6cf93b24dd8d1c5a5349c166f0f1fb15005f6%2Fswatch-card-hero.png?alt=media" alt="Swatch card shown on a product"><figcaption></figcaption></figure>

### **Function**

Displays each variant as a **polaroid-style card** showing the **swatch (image or color)**, the **option value**, and the **price (optional)** in one layout — so customers see the key details of every variant at a glance.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FbrujhhNFlFDaoonxr57E%2Fimage.png?alt=media&amp;token=b51e70af-5293-4a37-be4f-ef2a96eea8e6" alt=""><figcaption></figcaption></figure>

### **How it works**

* Each value appears inside its own **card**: preview on top, label (and optional price) below.
* The selected card is **visually highlighted**.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fwq8bdXkIm6Cy2qGA2cDp%2Fimage.png?alt=media&amp;token=cc6dd2c2-ac2a-467d-bd97-0be5f9367503" alt=""><figcaption></figcaption></figure>

* The swatch inside each card comes from one of two **sources** you choose: [Auto image swatch](https://docs.optis.me/swatch/variant-display/auto-image-swatch.md) or [Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch.md).

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FPhO4P2I7GenxsaxLqygV%2Fimage.png?alt=media&amp;token=631baeda-6c50-4399-b9cc-4d35c20c7c66" alt=""><figcaption></figcaption></figure>

### **Use when**

* Variants differ in **appearance and price**.
* You want customers to **compare options easily** without clicking back and forth.
* You have room on the product page for a richer, more visual selector.

***

## How to use Swatch card

{% stepper %}
{% step %}

#### Change the display type to Swatch card → Click Save

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FXJd9LWv4tkZpBot3EHZQ%2Fimage.png?alt=media&amp;token=1a321c5c-3045-400b-a51a-6452f3fd1ac7" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Open the editor (pencil icon) and choose the swatch source

Click the **pencil / edit icon** next to the display type. At the top of the editor, use the **source** dropdown to pick where the card's swatch comes from:

* [**Auto image swatch**](https://docs.optis.me/swatch/variant-display/auto-image-swatch.md) → uses the variant images already set in your Shopify product. No per-value setup needed.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-9c3e9ee8644a932c4209bc550f0e679308925421%2Fswatch-card-source-auto-image.png?alt=media" alt="Swatch card using the Auto image swatch source"><figcaption></figcaption></figure>

* [**Custom swatch**](https://docs.optis.me/swatch/variant-display/custom-swatch.md) → set each value by hand: upload your own images, or use solid colors / two-color splits (hex codes). The editor lists every value with a live preview.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-840c52daa7213a91ea64309c3692038da4ad0705%2Fswatch-card-source-custom.png?alt=media" alt="Swatch card using the Custom swatch source"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Click Save to apply changes

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FC9pqWN8pAOYi9uGyZjjd%2Fimage.png?alt=media&amp;token=a50f3098-69f8-4d34-a7b5-fee2564559fc" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="info" %}
On the **Custom swatch** source you can also use **✨ Auto-assign swatch**, **Bulk update**, and override a product's swatch individually — exactly as in [Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch.md).
{% endhint %}

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FRtaQJQbU8USjYXlZHlvn%2Fimage.png?alt=media&amp;token=d9535b43-2ec2-47e8-be23-fbccb767b3df" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Show price** on the card, along with card **size, spacing, text, and colors**, is configured in [Styling](https://docs.optis.me/swatch/styling/styling-overview.md) — not in this editor.
{% endhint %}

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FTbREIGR32BFgWm7m8CZ6%2FScreenshot%20(23).png?alt=media&amp;token=99b46e3c-9e24-49e9-b838-98047824793c" alt=""><figcaption></figcaption></figure>

***

## How it looks on your store

* **Product page:**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-9ab25990e2a8ec15958dd6715271f184eb67ff58%2Fswatch-card-product-page.png?alt=media" alt="Swatch card on the product page"><figcaption></figcaption></figure>

### Related

* [💊 Pill swatch](https://docs.optis.me/swatch/variant-display/pill-swatch.md) — a more compact image + label option
* [🎨 Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch.md) / [🖼️ Auto image swatch](https://docs.optis.me/swatch/variant-display/auto-image-swatch.md) — the two sources
* [Styling settings reference](https://docs.optis.me/swatch/styling/styling-settings-reference.md) — show price, sizing, colors
