How do I verify that my WooCommerce product gallery can actually display an MP4?

Set a controlled fixture

Create or use a test copy of one product rather than changing the live catalog first. Prepare exactly two distinguishable assets: Asset A is an illustrative MP4 named “blue-mug-spin.mp4”; Asset B is an illustrative poster image named “blue-mug-poster.jpg”. The names and any file dimensions are only illustrative; use assets you can identify unambiguously in the Media Library.

Before comparing results, record the WooCommerce version, whether the product is edited through a classic or block-based gallery, and the active theme. Do not assume that controls or behavior documented for one gallery implementation apply to the other. The featured Product Image is already the first gallery item, so place the poster deliberately if its position matters to your test.

1. Open the test product’s product-media area and identify the Product Image and gallery assignments.
2. Check the current WooCommerce version and note whether the editor presents a classic or block gallery.
3. Add Asset A and Asset B only to the test product, then save or publish according to your normal workflow.
4. Open the storefront product page in a fresh browser view and inspect the gallery itself.

Inspect evidence, not intent

A valid test requires more than seeing an MP4 listed in the Media Library. Confirm whether the storefront renders a video object or video control, whether the poster appears as the intended preview, and whether selecting the gallery item changes the displayed media. Record the exact visible result and any browser or theme message.

Also test the gallery’s normal interaction path: thumbnail selection, opening the main item, and playback if a playback control is present. Zoom and lightbox behavior depends on the implementation and theme, so treat those as separate observations rather than proof that MP4 support exists.

Illustrative exercise

Illustrative exercise: define Asset A as the MP4 “blue-mug-spin.mp4” and Asset B as the poster “blue-mug-poster.jpg” before making any A/B comparison. On the test product, place both in the gallery and identify which thumbnail represents each asset. A pass means the storefront shows a distinct video item for Asset A, displays Asset B as its poster or image as intended, and the video can be selected and played through the gallery’s visible controls. A fail means Asset A is absent, becomes only a static image, produces an error, or cannot be selected; Asset B appearing normally does not convert that result into a pass.

1. If Asset A plays, test the same product template with the intended product before publishing broader changes.
2. If Asset A fails while Asset B works, record the failure and check version, gallery type, and theme implementation; do not delete shared Media Library media.
3. If Asset A works on the test product but not the target, compare the target’s Product Image and gallery assignments and retest.

Acceptance condition

Accept MP4 gallery support only when the exact storefront configuration under consideration passes the fixture: the MP4 is assigned to the test product, appears as a selectable gallery item, renders as video rather than only as a file or still image, and playback works through the displayed gallery controls. Keep the test evidence tied to the recorded WooCommerce version, gallery implementation, and theme. If any condition fails, report the result as “not verified” rather than assuming a catalog replacement will fix it.

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.