Troubleshooting

WooCommerce's default gallery still shows

1. Check Enable Product Gallery on the General tab.
2. Block theme: if the single product template uses WooCommerce's newer Product Gallery block, swap it for the Product Image Gallery block or a Shortcode block with [siteryn_pgz_gallery].
3. Page builders and some themes use their own product image widget. Replace it with the shortcode.

Settings changes don't appear

1. Each tab saves separately: click Save Changes on the tab you changed.
2. Clear page, CDN and optimization plugin caches.
3. Tablet or mobile overrides ignored: turn on Enable Responsive Breakpoints on the General tab.
4. With Pro, some Free settings don't apply to Pro styles; see Shared settings.

The gallery looks unstyled on a page

The Free shortcode and template tag load styles only on product pages, and only while Enable Product Gallery is on. Use a Pro style shortcode (which loads its own), or enqueue the assets as shown in the Developer guide.

Zoom doesn't work

• Choose a Zoom mode on the Zoom tab; the default is None.
• Lens and Window zoom are for mouse pointers; on phones only Inner Zoom works.
• Zoom looks blurry: upload larger product photos (at least 1500 px wide).
• Window Zoom on the Pro Grid, Modern Grid, Masonry, Split, Video and Vertical Scroll styles and the Fullscreen cover does nothing; choose Inner or Lens.
• Lens shape Square or Panel position Left of image has no effect: in 1.0.0 the lens always shows as a circle and the Window panel always opens on the right. See Image zoom.

Tapping the image on a phone doesn't open the lightbox

With Inner Zoom, a tap zooms instead. Choose None, Lens Zoom or Window Zoom to open the lightbox on tap. Also check Enable Lightbox on the Lightbox tab.

Variation images don't change

• Give each variation an image under Variations on the product.
• Pro Grid, Modern Grid, Masonry, Split and Video styles don't follow variations.
• If a page shows two variable products (for example a quick view on a product page), only the first form updates the gallery.
• WooCommerce 10.8+ variation galleries (several images per variation) aren't supported.

Gallery doesn't work in a quick view or popup

Galleries loaded after the page (by AJAX) aren't initialised. Link to the product page instead, or see the Developer guide.

My Pro style doesn't show Pro

1. Check that the license is Active on the License tab. Without it, the Free gallery shows.
2. Check that the style is selected on Premium Gallery and saved, and that Enable Product Gallery is on.
3. Clear your caches.

If Premium Gallery shows a Pro preview banner and has no Save button, the license isn't active: activate it first.

The product summary doesn't stick Pro

Raise Sticky top offset if a fixed header covers it. In block themes, enter your summary column's selector in Sticky target selector. See Sticky product summary.

A video doesn't play or disappeared Pro

• The link was dropped on save: use a YouTube or Vimeo page link, or an .mp4, .webm or .ogv file.
• A self-hosted video won't start: turn on Show playback controls or Autoplay.
• Videos show only with the Video Gallery style or [siteryn_pgz_pro_video].

"Pro is almost ready"

Pro needs the Free plugin and WooCommerce active. This notice also appears when WooCommerce is inactive, even if Free is active: activate WooCommerce.

Still stuck?

Contact Siteryn support with a screenshot of System Status, your theme name, the product page address and the steps to reproduce.