Media grouping

With media grouping, your product pages will show only the relevant media for the selected variant and hide the rest.

If you want to show different product details as well as images, you may want to use Sibling product swatches, which links variants to their own product pages.

Why is the featured product image blank?

If you have media grouping and the show featured media first option enabled, the featured image may be blank if the featured image is not included in a media grouping. Either add the featured image as the first image in each media grouping, or turn off the option to show featured media first(click Product overview section to find settings).

Set up media groups

---

To create media groups for variants, first re-order the product media for each of variant in sequence, so that they are grouped together and follow the same order as your product options. Then assign the first image of each group to the related variant.

When selected, variants will display the assigned image and all following images up until the next variant's assigned image.

In your Shopify admin, go to Products to open the product you want to edit:

1

Re-order product media in the same order as variants

Using the drag-and-drop handles ⋮⋮, re-order your product media to group together items for each variant. The order of the groups should match the order of the variants.

All media for the first variant should be in the top positions, followed by all media for the second variant, followed by all media for the third variant, etc.

Images ordered for the color variants 'Purple', 'Green,' and 'Yellow'.

2

Assign the first image of each group to variants

In the Variants section, click the Add image button next to each variant. Select the first image of the group related to that variant.

If no image is assigned, the media gallery will not update and will continue to show images of the previously selected variant.

If your product has multiple options, assign the first image to each variant of that option.

For example, if your product has both color and size options, assign the first group image to variants with the same color.

Assign the first group image to the related variant.

For multiple product options, assign the first group image to each related variant.

Enable media grouping

---

After you've set up media groups for your variant images, you can enable media grouping in the Product overview settings of your product template.

In your theme editor (Customize):

1. Open the product template.

2. Click the Product overview section.

3. Toggle on Enable media grouping option.

4. Click Save.

---

Related links Media gallery Variant swatches Sibling product swatches