Check the store’s variant-to-image assignment and the actual product-page behavior. Correct filenames do not automatically bind a photo to a selectable color or size. Open each option as a buyer would, observe the displayed image and compare it with the real variant. If the mapping is correct in the product record but the storefront still behaves incorrectly, investigate the theme or gallery configuration.
Separate asset records from storefront settings
The asset record establishes which photograph represents which item. The store configuration decides which image appears when an option is selected. Shopify documents assigning images to variants. Its supported assignment model is a store feature, not something a new AI image or its filename controls.
Make a small test matrix containing the option label, variant identifier, assigned image and observed storefront image. Use actual product identifiers rather than a generic prompt label such as blue version. Keep an unedited reference for the real color so a correct mapping does not accidentally validate a generated color that the product does not have.
Test the published selection path
- Confirm that the relevant variant exists and is available in the product record.
- Assign its reviewed image using the store’s supported controls.
- Open the published page without an editor preview overlay.
- Select each option and compare the active image with the test matrix.
- Repeat on a phone, where gallery navigation may behave differently.
Check direct links to a selected variant if the shop supports them. A link opened from an ad or a saved cart may start on a different option from the default page. The expected image should remain understandable in both paths.
Avoid a misleading gallery repair
Putting every color into a collage can hide a broken selector without fixing it. Buyers may still misunderstand which option is in their cart. Likewise, a newly generated color variant should not be used as evidence that the physical item matches it. Resolve identity and mapping separately.
What if the photo updates but the gallery stays on another slide?
Record that behavior and check the receiving theme’s gallery settings. Do not keep uploading duplicate images to force a visual refresh. Make one controlled change and repeat the buyer-path test.
Do I need a new AI generation for every size?
Only when the visual asset actually needs to differ. Store variants and image derivatives are separate decisions. Reuse an accurate approved image where appropriate, while ensuring that size information and the selected item remain correct.
Sources and scope
This is an original Imagild Editorial workflow guide, assisted by AI and reviewed against the linked sources on October 12, 2026. External tool procedures do not imply that Imagild provides those tools or guarantees their results.