Why does one WooCommerce variation keep showing the parent product photo?

Isolate one affected combination

Work on a non-destructive test copy of the variable product, if available, and note the affected combination by its attribute values. Do not infer the image assignment from the swatch color or label: presentation and the variation’s media record are separate evidence.

Record the parent product’s current photo and the expected photo for the affected combination. Keep the storefront page and product editor available so you can compare what is assigned with what the shopper sees.

1. Open the product’s variation records and locate the exact combination reported by the shopper.
2. Inspect that record’s image assignment and compare it with the parent product’s media assignment.
3. Record the result before changing anything.

Choose the next check from the evidence

If the affected variation has no image assigned, or its assignment is the parent photo, assign the intended photo to that variation on the test copy. Save the change and reload the product page before judging the result.

If the variation record already points to the intended photo, do not keep changing its swatch or reassigning the same image. Test the storefront states below on the actual theme and version; note whether the selected combination is available and whether the displayed image changes. The observed behavior may depend on the site’s setup, so confirm it there rather than assuming a universal theme response.

1. Missing or parent-matching variation image: correct that variation’s assignment, then retest.
2. Correct variation image but storefront still shows the parent photo: capture the selected values and displayed image, then compare default, selected, reset, and unavailable states to narrow down where the mismatch occurs.

Run the storefront check

Use the same product page and browser session for each state, and wait for the page to finish updating after each selection. Note the selected attribute values and the image currently shown; a color swatch alone does not prove which variation record is active.

1. Load the product with no options selected and record the default image.
2. Select the affected combination and record its selected values and displayed image.
3. Reset the selection and record whether the default image returns.
4. If an unavailable combination can be represented on the page, record what the page displays; do not treat it as evidence about an available variation’s image assignment.

Illustrative exercise

Illustrative exercise: Define two fictional assets before comparing them. “Parent photo” means a blue ceramic mug on a white background; “variation photo” means the same mug photographed beside a wooden spoon. Define the affected combination as “Glaze = Moss” and “Capacity = Small.” These names and values are illustrative, not tested WooCommerce data.

On a test copy, inspect the record for Glaze = Moss and Capacity = Small. If its image assignment is empty or points to the parent photo, assign the variation photo, then select that combination on the storefront. Pass means the selected combination displays the variation photo and resetting returns to the parent photo. Fail means the selected combination still displays the parent photo, or the image does not correspond to the selected combination; capture the record and page state for the next investigation.

Acceptance condition

Close the check only when the affected variation record points to the intended image and, on the actual storefront setup, selecting that exact combination displays that image. Also confirm that reset returns to the expected default image and record the unavailable-state result if that state is present. Keep the observed values and screenshots or notes with the test copy so another person can reproduce the check.

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.