Why does WooCommerce gallery zoom disappear after I switch themes?

Separate the two failure types

A sharp source image and an available zoom control are different things. The source file may contain enough detail while the new theme no longer exposes or implements classic gallery zoom. Conversely, a theme may support zoom while the assigned image is too small to make enlargement useful.

WooCommerce treats the featured Product Image as the first gallery item. Therefore, inspect both Product Image and Product gallery assignments before concluding that the theme caused the problem. Removing an assignment from the product is also different from deleting the shared media item from the Media Library.

1. Open the affected product editor and record the current Product Image and Product gallery entries without deleting anything.
2. Identify whether the page is rendering a classic gallery or a block gallery. Do not assume that a theme switch preserved the same gallery implementation.
3. Open the storefront product page and record the visible evidence: thumbnails, image enlargement, lightbox behavior, and whether the featured image behaves differently from gallery images.

Use a controlled comparison

Create a non-destructive test copy of the product, or use an existing preview workflow. Keep the Product Image and Product gallery assignments identical to the affected product. This fixture isolates presentation behavior from catalog data.

Compare the affected theme with the available theme configuration or preview while keeping the product, image files, and gallery type constant. If zoom returns only when the theme changes, the next action concerns theme support or implementation. If it remains absent in both, inspect the gallery type and product assignments before blaming the theme.

1. Write down the theme name, gallery type, Product Image, and Product gallery contents for the test copy.
2. Load the product page at the same viewport and inspect each image, including the featured image.
3. Branch: if the image opens or enlarges in the comparison but not in the switched theme, ask the theme maintainer whether that theme supports the classic gallery zoom behavior; do not infer support from source resolution.
4. Branch: if neither version enlarges the image, verify whether the page uses a block gallery rather than the classic gallery, then inspect the product assignments and the current WooCommerce version before relying on any media behavior.

Illustrative exercise

Illustrative exercise: define Asset A as the assigned Product Image named “Blue Mug Front,” and define Asset B as the first entry in Product gallery named “Blue Mug Detail.” These are two distinct assigned assets; the names are illustrative only. Keep both assignments unchanged in the test copy before comparing Theme Alpha and Theme Beta.

Pass means the expected gallery renders both assets, the featured image remains the first gallery item, and the intended enlargement or zoom control is visible and usable in the chosen theme. Fail means the assignments are present but the control or enlargement is absent only after Theme Beta is active; that result points to theme support or implementation, not automatically to a defective image file.

If Asset A enlarges but Asset B does not, inspect whether Asset B is actually assigned and whether its source resolution is materially different. Do not delete either shared media item during this test.

Accept or escalate

Accept the change only when the test copy reproduces the intended classic gallery behavior with the real Product Image and Product gallery assignments, and the same behavior is visible on the published product page after the theme change. If the theme lacks the required implementation, document the comparison evidence and consult its support or documentation for a supported setting or alternative gallery approach.

Keep the current theme and media intact while investigating. Do not treat a missing zoom control as proof that the original image was deleted, and do not treat a high-resolution file as proof that the theme must provide zoom.

Scope of the documentation

The official references below support tool behavior and feature boundaries. The test fixture, branching decisions and acceptance criteria are Itemlume editorial recommendations; citation does not imply endorsement. Illustrative sizes, names and timings are not your production specifications.