> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.optis.me/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).

# 🖼️Show Images per Variant

1. [OPTIS Color Swatch](/swatch)
2. [Variant Images](/swatch/variant-images)

# 🖼️Show Images per Variant

## ✨ What is Variant Images?

Variant Image allows the product image gallery to display **only the images of the selected variant**, keeping the product page clean and focused.

#### 🛠 How it works

* Each variant is linked to its own set of images
* When a customer selects a variant, the gallery updates instantly
* Images from other variants are hidden until selected

#### 🎯 Use when

* Each variant has its own visual set (e.g. different colors)
* You want a cleaner, less cluttered product gallery
* You want customers to focus on the selected variant

## ⚙️ How to set up

🎥 **Video tutorial:**

Watch this quick guide to see how Variant Images work in action and how to set it up correctly in Shopify.

${frame}[](https://iframely.net/JexxImcX)

🛠 **Step-by-step**

1. **Enable Variant Images in the app**

![Enabling Variant Images in the app](https://storage.crisp.chat/users/helpdesk/website/-/3/3/a/a/33aa6167236e0a00/683263c0-9b28-424b-8b62-271cee_14h6n5t.png)

2. In Shopify Product admin, group images by variant and place the primary image first

![Shopify product media grouped by variant with the primary image first](https://storage.crisp.chat/users/helpdesk/website/-/a/e/3/f/ae3faf0bb9caa800/2c716f49-754d-4bc3-b5a9-2e1b10_srxifd.png)

3. Assign each primary image to its corresponding variant

**Note:** The first image in each image group must be the **same file as the variant image** (select the exact image already uploaded in Shopify Files, not a re-upload)

![Product gallery showing only the selected variant's images](https://storage.crisp.chat/users/helpdesk/website/-/e/6/6/f/e66ff55ab93db800/fcf757d3-3edc-4f5c-aa2a-e0a337_k4acrj.png)

Once completed, the image gallery will automatically update when customers switch variants.

💬 If the variant images don’t behave as expected, just contact us - our support team is happy to help.