Enabling "Show selected variant images only" will update your product pages to only show images assigned to each variant. This is useful if you have products that are visually different. Using this will help show customers which variant they have selected. For example if you have a shirt in blue and red - you can show only the red product photos when customers have selected red.
Navigate to the product template
Go to Online Store > Themes > Customize
From the dropdown in the center of the top bar select Products > Default product
In Theme sections select Product main
Scroll down and toggle on Show selected variant images only
Order your images
Images must be ordered depending on their variants to ensure they are correctly shown when customers change their selection.
In your Admin, navigate to your Products
Upload all images under media in your product settings
Ensure the images are sorted in the same order as your variants
Assign featured images to each variant that match the first image.
The below image will help illustrate how to achieve this.
Troubleshoot variant image order on mobile
Confirm Show selected variant images only is still enabled on Product main (see the steps above). Without this toggle, the gallery may not swap to the correct media when customers change variants.
In Shopify admin > Products, open the product and verify each variant has a featured image that lines up with the gallery image you want customers to see first for that variant.
Check overall media order in the product admin. Sliders on small screens emphasize the first matching slide, so ordering that matches your variant list reduces confusion.
