---
title: How to Add Variation Attribute Images to the WooCommerce Product Gallery
description: Add variation attribute images to the WooCommerce product gallery so shoppers browse every color or style photo with zoom.
url: "https://wpfactory.com/docs/variation-attribute-images-in-product-gallery/"
updated: "2026-09-27"
category: Pro Features
---

# How to Add Variation Attribute Images to the WooCommerce Product Gallery

To add variation attribute images to the product gallery with Variation Swatches for WooCommerce - Color & Image Swatches Pro, go to WooCommerce > Settings > Variation swatches, tick Add images on Gallery, and save. The images set on each term of an Image-type attribute are then added to the gallery of variable products. This is a Pro feature.

### Before you start

- WooCommerce, active.
- [Variation Swatches](https://wpfactory.com/item/color-or-image-variation-swatches-for-woocommerce/) Pro (this is a Pro feature).
- A **variable** product that uses an **Image**-type attribute, with an image set on each term.

### How it works

When the option is on, the plugin looks at each variable product's attributes for an Image-type attribute. For every term of that attribute it takes the assigned image and appends it to the product's gallery image list. The result is that the swatch images join your normal product photos in the gallery, so the customer can open and zoom them.

Two conditions must hold, both verified in the plugin's own logic:

- The product is a **variable** product. Simple products are ignored.
- The product uses an attribute whose type is **Image**. Color and Label attributes do not add gallery images.

### Turn it on

1. Go to **WooCommerce > Settings > Variation swatches**.
2. Tick **Add images on Gallery**.
3. Save changes.

| Label | Option ID | Type | Default | Free/Pro |
| --- | --- | --- | --- | --- |
| Add images on Gallery | `alg_wc_civs_add_images_on_gal` | Checkbox | Yes | Pro |

![variable product gallery showing the attribute term images added alongside the main product photos](https://wpfactory.com/wp-content/uploads/variation-attribute-images-in-product-gallery-1.png)

### Set up the Image attribute first

This feature only has images to add if your product uses an Image-type attribute with an image on each term. If you have not built one yet, see [Adding image swatches to your products](https://wpfactory.com/docs/).

### Troubleshooting

- **No extra images in the gallery:** the product must be a variable product with an Image-type attribute. Color and Label attributes do not add gallery images.
- **A blank image appears:** a term has no image set. Edit that attribute's terms and upload an image on each one.
- **The order looks off:** attribute images are appended after your existing gallery photos, in the order the terms are returned.

### Ready to set this up?

Add images on Gallery is a Pro feature of [Variation Swatches](https://wpfactory.com/item/color-or-image-variation-swatches-for-woocommerce/). Upgrading takes a couple of minutes and unlocks this along with the rest of the Pro toolkit. [Get Variation Swatches Pro](https://wpfactory.com/item/color-or-image-variation-swatches-for-woocommerce/).

Related articles

- [How to Add Image Swatches to WooCommerce Products](https://wpfactory.com/docs/add-image-swatches/)
- [How to Add Label (Text) Swatches to WooCommerce Products](https://wpfactory.com/docs/add-label-swatches/)
- [How to Add Color Swatches to WooCommerce Products](https://wpfactory.com/docs/add-color-swatches/)
- [How to Set Up Color, Image and Label Attributes in WooCommerce](https://wpfactory.com/docs/set-attribute-admin-options/)
- [How to Show Only Valid Variation Combinations in WooCommerce](https://wpfactory.com/docs/show-only-valid-variation-combinations/)