# 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.

![](https://2284774530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbwRwUdWG4hlz-Emx-E%2Fuploads%2FaP6yrg84lNcOpehmcxwt%2FScreen%20Shot%202022-07-01%20at%206.22.22%20PM.png?alt=media\&token=1046c844-8341-400e-8cee-610ffa418fdf)

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

![](https://2284774530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbwRwUdWG4hlz-Emx-E%2Fuploads%2FcgrgSDhqvyuWbbBE3Znr%2FLink1_TAG.jpg?alt=media\&token=07810e1d-35d8-46c1-8b0f-abf9130b7f49)

#### App

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

![](https://2284774530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbwRwUdWG4hlz-Emx-E%2Fuploads%2FIzLjqh84ZzUYzsDnA3h3%2FScreen%20Shot%202022-08-08%20at%2010.05.27%20AM.png?alt=media\&token=37656c75-0200-4d82-a32f-d58bef9a789f)

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

![](https://2284774530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbwRwUdWG4hlz-Emx-E%2Fuploads%2FtA5fojYR4X07Rq1nzQMg%2FScreen%20Shot%202022-08-08%20at%2010.08.25%20AM.png?alt=media\&token=a0346bc2-95eb-4e5c-b988-159cc4c731db)

### 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.

![](https://2284774530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbwRwUdWG4hlz-Emx-E%2Fuploads%2FJpMgTC5Mwugd8XZucvm6%2FLink2_Global_Enable.jpg?alt=media\&token=8662727b-84da-403e-a9da-e674e10c271d)

## 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).

![](https://2284774530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbwRwUdWG4hlz-Emx-E%2Fuploads%2FiD9XCB1xdEiv1EI0gyYa%2FNew_feature.png?alt=media\&token=5926ecde-71ea-426b-8c5e-7f683585d814)