> 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/auto-image-swatch.md).

# Auto image swatch

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

✨Demo product: [Auto image swatch](https://optis-color-swatch-variant.myshopify.com/products/auto-image-swatch?_pos=1&_psq=auto&_ss=e&_v=1.0) (password: 1)

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

### **Function**

**Auto image swatch** turns the **variant images you already set in Shopify** into swatches — automatically, with no manual upload. Each variant value shows its own Shopify image as the selector.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-b2ae5875d30bdc9dec217d1b0ebb78c0db07ce0f%2Fauto-image-swatch-from-variant-images.png?alt=media" alt="Auto image swatches generated from Shopify variant images"><figcaption></figcaption></figure>

### **How it works**

* The app reads the **image assigned to each variant** in Shopify and uses it as the swatch.
* **No manual upload needed** — nothing to configure per value.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FwkG16uVmyhJfzO14WLYe%2Fimage.png?alt=media&amp;token=7053eab1-c57a-4347-99a1-5d0f1ecba9a9" alt=""><figcaption></figcaption></figure>

* When you **change a variant image in Shopify**, the swatch updates after the next **Sync** (use **Sync data** on the Variants display page, or wait for auto-sync).

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FXOEqkpf2UOdNOP4qEXEB%2Fimage.png?alt=media&amp;token=5fb614ea-24f9-4666-a948-5b092bfecf71" alt=""><figcaption></figcaption></figure>

* If a value has **no variant image**, it has nothing to show — use [Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch.md) to set an image or color for it instead.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FfW2V9138HFq387az3RGg%2Fimage.png?alt=media&amp;token=01df6b15-6824-427c-a935-6515b50d90e2" alt=""><figcaption></figcaption></figure>

### **Use when**

* Each variant already has its **own product image** (e.g. Color = Red, Blue, Black).
* You want swatches to **always stay in sync** with your Shopify images.
* You don't want to manage swatch images separately from your product images.

### **Auto image swatch vs. Custom swatch**

<table><thead><tr><th width="344.9765625">Auto image swatch</th><th>Custom swatch</th></tr></thead><tbody><tr><td>Uses the variant images already in Shopify</td><td>You set the image/color for each value by hand</td></tr><tr><td>Zero setup, stays in sync with Shopify</td><td>Supports solid colors, two-color split, and uploaded images</td></tr><tr><td>Needs every variant to have an image</td><td>Best for colors, patterns, textures, or values with no image</td></tr></tbody></table>

***

## How to use Auto image swatch

{% stepper %}
{% step %}

#### Change the display type to Auto image swatch → Click Save

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FutteI49uhBRJEv1plMFs%2Fimage.png?alt=media&amp;token=ab1f1950-5333-434e-9636-9581ce564418" alt=""><figcaption></figcaption></figure>

In **Variants display**, set the option's **Product page display** (and/or **Collection page display**) to **Auto image swatch**.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FHeCTbRP3MstDQHduDG37%2Fimage.png?alt=media&amp;token=f997f99d-6d06-4153-8da8-cfd1ae71ba47" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Make sure each variant has an image in Shopify

Assign an image to every variant value on the Shopify product. Values without an image won't render a swatch.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FuSyy7bTyZSiymSdcimr8%2Fimage.png?alt=media&amp;token=778e20d1-fae0-4b58-85c4-7fd43fcf3e48" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Sync so the app picks up your latest images

If you added or changed variant images, click **Sync data** on the Variants display page so the swatches reflect them.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2F9dVBJ9p6JRwhh7Sfk5mm%2Fimage.png?alt=media&amp;token=6d7d7084-93a3-40a1-bba9-ca28b75d5a99" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Want the swatches to show **colors, patterns, or textures** instead of the full product photo — or fill in values that have no image? Use [Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch.md).
{% endhint %}

***

## 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-9ac988ffe661679b70d8bc00abbf87c819801c85%2Fauto-image-swatch-product-page.png?alt=media" alt="Auto image swatch on the product page"><figcaption></figcaption></figure>

* **Collection page:**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2Fgit-blob-9e41c8f4db162be544662d7fb8752db7c83e3d13%2Fauto-image-swatch-collection-page.png?alt=media" alt="Auto image swatch on the collection page"><figcaption></figcaption></figure>

{% hint style="info" %}
Want to change the **size, shape, spacing, or border** of the swatches? That's handled in [Styling](https://docs.optis.me/swatch/styling/styling-overview.md).
{% endhint %}

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FpUZ7yDroDCF6AyZtDwKI%2FScreenshot%20(19).png?alt=media&amp;token=2b6198ab-d728-4633-91aa-5af3b5d33ee9" alt=""><figcaption></figcaption></figure>

### Related

* [🎨 Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch.md) — set images/colors manually
* [🪄 Auto-assign swatch](https://docs.optis.me/swatch/variant-display/auto-assign-color-swatch.md) — fill colors in one click
* [Why is my image swatch blurry?](https://docs.optis.me/swatch/frequently-asked-questions/why-is-my-image-swatch-blurry-and-how-can-i-fix-it.md)
