The functionality of the WooCommerce Additional Variation Images extension is now built into WooCommerce itself as of version 11.1.
That means you no longer need a separate extension to add image galleries to your product variations; it’s a native WooCommerce feature available to every store, for free.
Read the announcement on the WooCommerce developer blog: WooCommerce 11.1.0: Release Notes and developer advisory: Additional Variation Images included in WooCommerce 11.1.
Any store that still has the WooCommerce Additional Variation Images extension installed, WooCommerce automatically deactivates the extension and migrates its data into WooCommerce core. The extension was formally retired on September 5, 2026.
The native Variation Gallery
↑ Back to topWooCommerce 10.9 introduced the Variation Gallery behind the Experimental features and now WooCommerce 11.1 turns it on for every store and removes the toggle entirely, so there is nothing left to enable.
If you already use WooCommerce Additional Variation Images, first test the native feature with a copy of your store on a staging site. Also check any theme customizations, gallery extensions, and custom code that changes product images.
When you enable the native feature, WooCommerce automatically deactivates the standalone WooCommerce Additional Variation Images plugin to avoid running both implementations at the same time.
Migrate existing variation galleries
↑ Back to topAfter you enable the native feature, WooCommerce copies existing extension galleries to the native variation-gallery field in batches. The migration:
- Copies images only when the variation does not already have a native gallery.
- Leaves the extension’s original image data unchanged.
- Runs in the background, so stores with many variations may need time to finish.
To check the background work, go to WooCommerce > Status > Scheduled Actions. Look for actions in the woocommerce-db-updates group. If the migration is still pending, allow the scheduled actions to run before checking every gallery on the storefront.
For instructions on adding images with the native feature, see Add images to a variation.
Reactivating the extension after migration
↑ Back to topOnce the extension has been deactivated and its data migrated, reactivating it is blocked. If you or a merchant tries to activate WooCommerce Additional Variation Images again, WordPress refuses with:
This plugin cannot be activated because its functionality is now included in WooCommerce core.
This is expected. The extension was formally retired on September 5, 2026, and its functionality now lives in WooCommerce core for every store — there’s no supported path back to running the standalone plugin. The migrated gallery data stays in the native field described above, and the extension’s original data is left untouched.
Import variation galleries with CSV
↑ Back to topThe standalone extension and the native feature store variation galleries in different custom fields. Use the field that matches the implementation active on the store.
| Implementation | CSV column | Value |
|---|---|---|
| WooCommerce Additional Variation Images extension | meta:_wc_additional_variation_images | Comma-separated image attachment IDs |
| Native WooCommerce Variation Gallery | meta:_product_image_gallery | Comma-separated image attachment IDs |
With Product CSV Import Suite, a useful starting point is to configure one variation gallery manually and export that product. The export shows the structure you can use for the remaining variations.
Theme compatibility
↑ Back to topThe extension works with themes that use the standard WooCommerce product gallery and lightbox. A theme that replaces the gallery with its own implementation may need compatibility work from the theme author.
The native feature supports the classic WooCommerce Product Gallery and the block-based Product Gallery. Test variation selection, image switching, thumbnails, zoom, and the lightbox on both desktop and mobile before using a new gallery implementation on a live store.
Troubleshoot variation galleries
↑ Back to top- Confirm whether the store is using the standalone extension or the native feature. When the native feature is enabled, the extension should be inactive.
- Confirm that the parent variable product has a product image or product gallery.
- Clear site and browser caches, then test the product again.
- Temporarily switch to Storefront or a current default WordPress theme. If the gallery works, contact the theme author about gallery compatibility.
- If the problem continues, perform a conflict test with only WooCommerce and the gallery implementation you are testing active.
See the conflict testing guide for a safe testing workflow.
Developer notes
↑ Back to topThe following filters and JavaScript events belong to the standalone WooCommerce Additional Variation Images extension. They are not part of the native WooCommerce Variation Gallery feature:
wc_additional_variation_images_gallery_images_classwc_additional_variation_images_main_images_classwc_additional_variation_images_frontend_before_show_variationwc_additional_variation_images_frontend_initwc_additional_variation_images_frontend_lightbox_done
For the native feature, read gallery IDs with WC_Product_Variation::get_gallery_image_ids() or the woocommerce_product_variation_get_gallery_image_ids filter. Variation data passed through woocommerce_available_variation includes gallery_image_ids and gallery_images_html. On the storefront, use WooCommerce’s existing show_variation and reset_data events instead of extension-specific events.
See Bringing Variation Galleries into Core for the native data model, REST API fields, and compatibility details.
Questions and support
↑ Back to topHave a question before you buy? Contact our sales team.
Already purchased and need assistance? Contact WooCommerce support.