If you sell a t-shirt in six colours, a shopper who picks “forest green” wants to see the forest green shirt from the front, the back and up close, not one lonely image while the parent gallery keeps showing the black one. For years that meant buying the WooCommerce Additional Variation Images extension or installing a third-party gallery plugin. As of WooCommerce 11.1, released on 3 September 2026, every variation can carry its own ordered image gallery natively, for free, with no extension. This guide shows you how to set it up, what happens to galleries you already built with a plugin, and what to check before you trust it on a live store.
Quick answer
Update to WooCommerce 11.1 or later, open a variable product, expand a variation and click Manage next to Variation gallery. Drag in as many images as you like and order them; the first image becomes that variation’s primary image. The storefront swaps the whole gallery when a shopper selects that variation, in both classic themes and the block-based Product Gallery. If you were using the official Additional Variation Images extension, your galleries migrate automatically in the background and the extension is deactivated. If you use a third-party gallery plugin, check its changelog: RadiusTheme and GetWooPlugins have both shipped migration paths, but you may lose slider, zoom or lightbox styling that the plugin provided.
What changed in WooCommerce 11.1
Until now, WooCommerce core allowed exactly one image per variation. Selecting a variation swapped the main image and left the rest of the gallery showing the parent product’s photos. Stores that needed more bought the Additional Variation Images extension from WooCommerce.com or installed a free alternative from WordPress.org.
WooCommerce brought this into core in three steps, according to the roadmap post on the WooCommerce Developer Blog: an opt-in beta in 10.9 (June 2026), a 5% canary rollout in 11.0, and full enablement in 11.1. The 11.1 release notes state plainly that “variation galleries are now enabled for all stores in WooCommerce 11.1 and WooCommerce Additional Variation Images is being retired.” The experimental toggle that used to sit under WooCommerce > Settings > Advanced > Features was removed by the 11.1 database update, so there is nothing to switch on; the feature is simply there.
The release itself slipped by two days. WooCommerce found mini cart issues while testing the first release candidate and moved the stable date from 1 September to 3 September 2026. The retirement of the Additional Variation Images extension followed on 5 September.
Why this matters for conversion
Colour, finish and material are exactly the attributes shoppers cannot judge from a single thumbnail. A variation gallery lets a furniture store show the walnut finish on the tabletop, the legs and the drawer front, and lets a fashion store show the same dress on a model, flat and in detail for every colour. WooCommerce’s own product update page calls out clothing, furniture, home goods and electronics as the obvious beneficiaries. If you have been paying for an extension or living with a single image per variation, this update removes a cost or a limitation, and in some cases both.
How to add a variation image gallery (step by step)
You need a variable product with at least one variation already saved. If you are new to variations, start with our guide to adding variable products in WooCommerce and the deeper walkthrough of WooCommerce attributes and variations, then come back here.
- Confirm your version. Go to WooCommerce > Status and check that the WooCommerce version reads 11.1.0 or higher. If it does not, update first, ideally on staging, following our checklist on how to update WooCommerce safely.
- Open the product. Go to Products, edit the variable product, and scroll to the Product data panel. Select the Variations tab.
- Expand the variation. Click the variation you want to illustrate, for example “Forest green, Large”. Next to the variation image you will now see a Variation gallery field with a Manage button.
- Add images. Click Manage and pick images from the media library or upload new ones. You can drag and drop to reorder. The variation’s featured image and its gallery are presented as one ordered list, and the first item is promoted to primary automatically.
- Save. Click Save changes in the Variations tab, then Update the product.
- Check the storefront. Open the product page, choose the variation, and confirm the gallery swaps to that variation’s full image set. Clear the selection and confirm the gallery resets to the parent product’s images.
Repeat for each variation that needs its own photos. Variations without their own gallery keep the previous behaviour (the variation image, if set, swaps in as the main image), so you do not have to fill every one.
Tips for a gallery that actually helps shoppers
- Lead with the hero shot. The first image becomes the variation’s primary image everywhere it is shown, including the swap on selection, so put the cleanest packshot first.
- Keep the same shot order across variations. Front, back, detail, in use. A shopper flipping between colours can then compare like with like.
- Do not duplicate the parent gallery. Only add images that differ by variation. Size variations of the same colour rarely need separate galleries at all.
- Watch your media library. Six colours times five images is thirty uploads for one product. Compress before upload and keep dimensions consistent so the gallery does not jump.
Already using a variation gallery plugin? Here is what happens
This is where most stores need to pay attention, because the answer depends on which plugin you used. There are three common situations.
1. The official Additional Variation Images extension
Nothing to do, but plenty to verify. When your store updates to 11.1, WooCommerce deactivates the extension automatically to prevent conflicts and schedules a background Action Scheduler job that copies each variation’s images from the extension’s meta key into the native gallery field. According to the engineering post on the Developer Blog, the job processes up to 250 variations per run and requeues itself until every variation is done, so a catalogue with thousands of variations may take a while to finish. The migration is idempotent and never overwrites a native gallery that already has images, and the extension’s original data is left in place, so you can roll back if something goes wrong.
To confirm it completed, go to WooCommerce > Status > Scheduled Actions and look at the woocommerce-db-updates group. Wait until the migration actions show as complete before you judge the storefront; if you look too early, some variations will still show a single image.
2. A third-party gallery plugin
Core only migrates the official extension’s data. Third-party plugins stored images under their own meta keys, so their galleries do not move into the native field unless the plugin does it for you. The two most-installed free options on WordPress.org have both responded:
- Additional Variation Images Gallery for WooCommerce by GetWooPlugins (20,000+ active installs): version 1.3.33, released 6 September 2026, adds a migration option. Go to GetWooPlugins > Gallery Settings > Migration and click Start Migration. After a successful migration, the plugin’s FAQ says WooCommerce’s built-in gallery manages your variation images.
- Variation Images Gallery for WooCommerce by RadiusTheme (10,000+ active installs): version 2.4.5, released 13 September 2026, adds support for the 11.1 native gallery and migrates existing galleries automatically. The same release notes a fix so that a single problem variation can no longer stall the migration on large stores.
GetWooPlugins, for example, now positions its plugin as working alongside the native gallery and adding what core lacks: thumbnail positioning, sliders, zoom and lightbox controls. So the decision is not just “migrate or not” but “do I still need the plugin’s presentation layer after the data lives in core?” For many stores the honest answer is no, and one fewer plugin is a performance and maintenance win. For stores whose product pages depend on a specific slider look, keep the plugin, migrate the data, and test.
3. A theme with its own variation gallery module
Several premium themes bundle a variation gallery feature. These are not migrated by core either. Check your theme’s changelog for 11.1 compatibility, and test on staging whether the theme’s module and the native gallery fight over the product page. If they do, disable the theme module and rebuild the galleries natively; the theme vendor’s support channel will usually have a documented path by now.
Under the hood: where the images live
Developers and anyone who imports products programmatically should know the data model, because it is deliberately the same one parent products have used for years.
| Where | Key or property | Notes |
|---|---|---|
| Variation post meta (native) | _product_image_gallery | Comma-separated attachment IDs, identical to the parent product’s gallery meta. Separate from the variation’s featured image. |
| Legacy extension meta | _wc_additional_variation_images | Preserved after migration for rollback, but no longer authoritative. Edits made in core are not synced back to it. |
| REST API (wc/v3) | gallery_image_ids on variation endpoints | Readable and writable, accepting an array of attachment IDs, matching the parent product structure. |
| PHP | WC_Product_Variation::get_gallery_image_ids() and set_gallery_image_ids() | Use these instead of reading meta directly. |
Because the REST field is writable, you can populate galleries in bulk from a PIM or a script: PUT to /wp-json/wc/v3/products/{product_id}/variations/{variation_id} with a gallery_image_ids array. The release notes do not describe changes to the built-in CSV importer for variation galleries, so if you rely on CSV imports, test a small file first rather than assuming the importer writes the new field.
Theme developers can relax slightly: WooCommerce states that overrides of single-product/add-to-cart/variable.php remain supported. The one thing worth testing is the reset behaviour, meaning that when a shopper clears their selection, the gallery returns to the parent product’s images. If your extension renders WooCommerce blocks during REST or Store API requests, note that 11.1 also stops registering blocks on non-rendering requests (the change that makes those requests 30 to 42% faster, per the release notes) and offers a woocommerce_should_register_blocks filter to opt back in.
Common mistakes and how to avoid them
- Judging the migration before it finishes. Large catalogues migrate in batches of 250 variations. Check Scheduled Actions first.
- Reactivating the retired extension. Core deactivated it on purpose. Running both risks conflicts on the product page, and the extension is no longer maintained.
- Assuming a third-party plugin’s images moved. They did not unless you ran that plugin’s migration tool or its update did it for you. Spot-check a handful of variations on the front end.
- Uploading uncompressed photography. Galleries multiply image count per product. Optimise before upload and make sure lazy loading is on.
- Leaving stale conditionals in custom code. Any code that checked the old
wc_feature_woocommerce_additional_variation_images_enabledoption should be removed; the option no longer exists.
Bonus: product gallery videos are in beta too
WooCommerce 11.1 also ships experimental support for videos in both classic and block-based product galleries. It is off by default and, in this first version, supports locally uploaded videos only, so no YouTube or Vimeo embeds yet. To try it, go to WooCommerce > Settings > Advanced > Features and enable Product gallery videos (Beta). Because it is a beta, treat it as a staging experiment for now. If you need hosted video on product pages today, our guide to adding product video to your WooCommerce gallery covers the plugin route.
FAQ
Do I need to enable anything to get variation galleries?
No. In 11.1 the feature is enabled for every store and the old experimental toggle has been removed. Just update and open a variable product.
Does it work with my classic theme?
Yes. WooCommerce says the galleries work in classic single-product templates as well as the block-based Product Gallery, and that theme overrides of the variable add-to-cart template are still supported. Test the selection and reset behaviour on staging, particularly if your theme replaces the default gallery script.
Is there a limit on images per variation?
WooCommerce has not documented a hard limit. The practical limit is page weight and admin usability; WooCommerce’s own testing call asked for feedback on products with many variations and many images each, so keep galleries lean on very large catalogues.
I paid for Additional Variation Images. What happens to my subscription?
The extension was formally retired on 5 September 2026 and its functionality is now free in core. Check your WooCommerce.com account for the subscription’s status; the product update page describes the result as “one less subscription to manage”.
Can I still use zoom, lightbox or a slider?
Core provides the gallery data and the swap; presentation comes from your theme or the Product Gallery block. If you want a specific slider or lightbox treatment, the third-party plugins above now read from the native field and layer their styling on top. Our roundup of WooCommerce product variation plugins covers the wider category.
Conclusion
Variation galleries in core are one of those quiet WooCommerce changes that fix a daily annoyance for a lot of stores. If you sell anything that varies by colour or finish, your next action is simple: update to 11.1 on staging, open your best-selling variable product, and give each colour its own three or four images. If you were using a plugin, confirm the migration finished before you look at the storefront, and then decide whether you still need the plugin at all. If you built variation images the old way, our earlier tutorial on displaying additional variation images in WooCommerce shows exactly what this release replaces.
Sources
- WooCommerce 11.1.0 release notes, WooCommerce Developer Blog
- Additional Variation Images included in WooCommerce 11.1, engineering post with migration details
- Bringing Variation Galleries into Core, roadmap post
- WooCommerce 11.1 release is delayed, advisory
- Create image galleries for every product variation with WooCommerce 11.1, WooCommerce product update
- What’s new with WooCommerce 11.1, WooCommerce blog
- WooCommerce Additional Variation Images documentation, retirement notice and migration steps
- Call for Testing: Variation Galleries in core, GitHub discussion
- Additional Variation Images Gallery for WooCommerce and Variation Images Gallery for WooCommerce, WordPress.org plugin pages and changelogs
Verification note: version numbers, release dates, plugin versions and settings paths in this article were checked against the sources above on 17 September 2026. WooCommerce ships monthly, and the video gallery feature is in beta, so re-check the release notes if you are reading this several releases later.
