Quick answer
If product images do not match variants, confirm that each variant has the correct image assigned in Shopify admin, then check option order, theme variant picker behavior, product media settings, and any apps that replace variant or gallery logic.
Common symptoms
- Selecting a color does not change the main image.
- The wrong image appears for a variant.
- Images work on desktop but not mobile.
- A variant image is correct in admin but wrong on the storefront.
- A swatch app and the theme seem to disagree.
Check 1: Variant image assignment
Shopify has a specific process for adding images to product variants. In admin, open the product, go to variants, and confirm each variant has the intended image assigned. For bulk products, use the bulk edit options carefully.
Check 2: Product media order
Product media order can affect what appears first. Make sure the default product image and variant images make sense together, especially if a theme shows the first media item before a variant is selected.
Check 3: Option names and order
Themes often expect option names like Color, Size, Material, or Finish. If the theme or app has custom swatch logic, inconsistent option names can break the expected behavior.
Check 4: Theme behavior
Some themes update the main image when a variant changes. Others rely on app code, custom JavaScript, or swatch settings. If the admin is correct but the storefront is wrong, the issue may be in the theme's variant JavaScript or gallery logic.
Check 5: App conflicts
Swatch apps, product option apps, combined listing apps, and gallery apps can all affect variant selection. Disable or test apps carefully on a duplicate theme before changing live code.
Fix path
- Assign the correct image to each variant in Shopify admin.
- Save and test a product with only standard variant behavior first.
- Confirm the theme variant picker changes the selected variant ID.
- Check desktop and mobile gallery behavior.
- Review swatch or product option apps if the theme logic is being overridden.
Common misunderstanding
Uploading images is not the same as assigning variant images
A product can have many images, but variant switching usually depends on the image being connected to the correct variant or on custom theme logic that maps images to options.