Gatemi Product Gallery FAQ and Troubleshooting

Open WooCommerce → Product Gallery and read the status card. It is written by the last product page viewed:

  • Your theme renders its own product gallery — your theme has replaced WooCommerce's gallery with its own. Switch the theme's gallery off in its customizer, or ask its author which hook it uses.
  • Your Single Product template draws its own gallery — your block theme's template contains WooCommerce's gallery block. See the next question.

If there is no status card, no product page has been viewed since the plugin was activated. Open one and reload the screen.

Does it work with a block theme?

Only where the product page uses WooCommerce's classic layout. In Appearance → Editor → Templates → Single Product, build the template around WooCommerce's Classic Template block. If the template uses the Product Image Gallery or Product Gallery block, the plugin stands aside, because that block prints its own gallery and the page would end up with two. The plugin has no block of its own.

I use a page builder for product pages

A builder that draws the product page without WooCommerce's woocommerce_before_single_product_summary hook will not show this gallery. Use the builder's own WooCommerce product-images widget if it calls WooCommerce's standard gallery, or keep that page on the theme's template.

Why are there no arrows or thumbnails?

They only appear when the product has more than one image. Add images to Product gallery on the product. Thumbnails also depend on Show thumbnails below the image (free) or Thumbnails (full edition).

Choosing a variation does not change the image

Free edition: give the variation its own image (Variations → the variation's image). Choosing it then shows that image in place of the first slide, as WooCommerce's own gallery does; a variation with no image of its own leaves the product's images showing. Clearing the choice puts the product's image back.

Full edition: check Swap the images when a variation is chosen is on. Give the variation its own image or its own Gallery images for this variation; a variation with neither shows the product's gallery.

A product video or viewer from another plugin has disappeared

Both editions fire WooCommerce's woocommerce_product_thumbnails action inside the gallery, which is where plugins such as Gatemi Product Info add a product video. If an item still does not show, that plugin is printing somewhere other than that action — check with its author.

Zoom does not work on my phone

Full edition. That is deliberate. Hover zoom needs a mouse; on a touchscreen it is never applied, and the lightbox shows the full-size image instead.

Does it slow the page down?

The images are printed by the server at your store's normal sizes, with the srcset WordPress already generates. Only the first image loads straight away; the rest are lazy-loaded. The plugin's stylesheet and script load only on a product page where it took the gallery over.

Does it work with a page cache or CDN?

Yes. The gallery is ordinary HTML and is the same for every visitor, so a page cache can serve it, and a CDN that rewrites image addresses keeps working.

Does it affect the cart, checkout or orders?

No. It changes only the product page gallery, so HPOS and the Cart and Checkout blocks are unaffected.

I moved from the free edition to the full edition

Both editions read the images already on each product, so there is nothing to move. The settings are stored separately (gmpgf_settings and gmpg_settings), so check the full edition's switches once. While the full edition is active the free one stands down.

What does uninstalling remove?

Free edition: the gmpgf_settings and gmpgf_theme_status options. Your product images are never touched, and the free edition never touches the full edition's per-variation images.

Full edition: the gmpg_settings, gmpg_theme_status and licence options, the cached update payload and the licence-check cron event. The per-variation image sets (_gmpg_images) are kept.

Shopping Cart
Scroll to Top