# Link Variant Images to Swatches

## Example

{% embed url="<https://variant-image-wizard.myshopify.com/products/candle-holder-linked-variant-images>" %}

## How to link

First, ensure that you have the **Product Image Gallery** switch toggled to the **on** position as shown in the screenshot below. You can find this switch by navigating to our app's home page and then clicking on the **Preferences** tab.

![](/files/Y18vmuq3IWBVhYpqOaAF)

Then, you can link your variant images to swatches (product options) by choosing between the **On an individual product basis** or the **Globally on all products** methods as discussed below.

### On an individual product basis

This can either be done through **Shopify Admin** or through the **App**.&#x20;

#### Shopify Admin

On the product page, scroll down until you see **Tags** on the right hand-side. Then, simply add **vw-variant-vi-link** as a tag

![](/files/xCPpYGfWoiFB6KXiY1LW)

#### App

Navigate to our app's all products page, and select the product you want to link

![](/files/6foQh0erP5wroayl1jqX)

Click the **More** button (three dots) followed by the **Link variant image to product option (swatch)** menu ite&#x6D;**.**

![](/files/kQyMkHyGD0MBxrDzzRG3)

### Globally on all products

On the app’s home page, simply click on the tab **Preferences**, found at top right corner. Then, on the tab **Product Image Gallery**, enable **Link variant image to product option (swatch)** by ticking the checkbox. Then, hit **Save** on the top right.

![](/files/nyjLEH8szAJufJA900mc)

## How to **assign multiple variant images to each variant while using this feature**

First assign all the images you want to link to the corresponding variants within the variant rows. Once completed, click on the **3 dots** button located at the top right corner of the page and then turn the **Variant Images** toggle to the **off** position, as shown in the screenshot below.


The app will then revert the product to using the standard product image gallery layout (where all images are shown), and clicking each image will change to the correct corresponding product option (swatch).

![](/files/JJSzupbvkpMaNZfp1rOP)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.productwiz.io/variant-wizard/faq/link-variant-images-to-swatches.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.