Changing the product image does not work

Advanced Product Fields for WooCommerce allows you to show different product images based on choices made by your customer.

This article offers troubleshooting tips if the product image doesn’t change, despite enabling the proper setting and configuration. Here’s an example of the correct configuration:

The cause

Our plugin’s “image switching” feature is only compatible with the default product gallery provided by WooCommerce. If a theme uses a custom-written gallery instead, our plugin is unable to change the images as it doesn’t have knowledge of the custom gallery’s inner workings.

Here are some themes that include a custom product gallery:

  • Porto
  • Blocksy
  • Avada
  • Kadence
  • X-store
  • Flatsome
  • Shoppe
  • TheGem

You can determine if your theme uses a custom product gallery by comparing its product gallery to the one in the WooCommerce Storefront demo store. If your gallery looks and acts quite different, there is a chance your theme is using a custom gallery.

The solution

Now that you’ve found out your theme is including a custom product gallery instead of the standard gallery provided by WooCommerce, what steps can you take to resolve this problem?

Some themes will include a setting or provide a code snippet to revert back to the default gallery in WooCommerce. We have documented the locations of these settings for a few popular themes:

If your theme is not included in this list, it’s worth exploring the possibility of a setting by:

  • Checking for such a setting in your theme’s settings panel or Appearance → Customize → WooCommerce.
  • Checking your theme’s documentation.
  • Asking the support staff of your theme if such a setting exists or if they can provide a code snippet.

Unfortunately, our plugin is only compatible with the standard product gallery provided by WooCommerce. If your theme lacks the capability to display that gallery, then the “image switching” feature of our plugin will not work.

It’s worth asking the authors of your theme if they are willing to include a code snippet or setting to revert back to the WooCommerce gallery. This will ensure that any plugin that adds extra functionality to the WooCommerce gallery will work seamlessly with your theme, making it a win-win situation.

Was this article helpful?

Related Articles