On Shopify, you can attach only one image to each variant, so a ring that comes in three metals and four stones will not swap a full photo set on its own. The practical fix has three parts. Assign a lead image to every variant, group the rest of the gallery by metal, and add a theme feature, app or small piece of custom code when you need more than one photo per option. This guide walks through each part with jewelry examples.
TL;DR
- Shopify’s native variant media accepts one image per variant, and no video or 3D model.
- Dawn’s ‘hide other variant media’ setting hides only the single image attached to each other variant, so it cannot filter a full photo set.
- For jewelry, make metal the primary option and let it drive the gallery, then handle stone and size with the lead image or a swatch.
- Multi-image galleries per variant need a theme that supports them, an app, or metaobject-based code. Choose the one that survives a theme change.
- Clean, consistent product data makes all of this easier to maintain across hundreds of SKUs.
Table of Contents
- Why jewelry variants break the default Shopify gallery
- What Shopify supports natively
- What Dawn’s ‘hide other variant media’ setting does and does not do
- Set up your options so the gallery can follow them
- Four ways to show more than one image per variant
- Photography that makes variant images work
- A step-by-step workflow for a new jewelry product
- Troubleshooting: selecting a variant does not change the images
- Our perspective
- Where JewelCloud fits
- FAQ
- Sources
Why jewelry variants break the default Shopify gallery
A t-shirt has a color and a size. A engagement ring setting has a metal, a center stone shape, a carat weight, a ring size and sometimes a finish. Each combination looks different in a photo, and shoppers judge a piece almost entirely by its photos.
Shopify’s default behavior is built for simple products. When a shopper picks an option, the theme jumps to the image attached to that variant. The other images stay in the gallery. If you shot six angles of the rose gold version, the shopper still scrolls past yellow gold and white gold shots to find them.
That mismatch matters for jewelry because the difference between metals is subtle in a thumbnail and obvious in a close-up. A diamond set in yellow gold reads differently from the same diamond in white gold. If the gallery shows a mix, shoppers wonder which one they are actually buying, and that hesitation shows up as abandoned carts and returns.
The photos look different online for reasons of lighting, reflection and screen calibration, which is one more reason to show only the photos that match the selected option and to keep a consistent shooting style across variants.
What Shopify supports natively
Shopify’s Help Center is clear about the limits. You can add only one image to each product variant, chosen from the product’s existing images or uploaded from your device. Variants also do not support other media types such as 3D models or videos.
To assign an image in the admin:
- Open the product and scroll to the Variants section.
- Click a variant.
- In the Image field, select an existing product image or add a new one.
- Repeat for each variant, then save.
Do this for every variant, even when you plan to add an app later. An app or theme feature usually keys off these assignments or sits on top of them, and an empty Image field is the most common reason a swatch click appears to do nothing.
The math of a jewelry product
Variant counts grow faster than most jewelers expect. A pendant with 3 metals and 4 stone choices has 3 × 4 = 12 combinations. If you want a hero shot, a close-up of the setting, a side profile and a worn shot for each one, that is 48 images for one product page. Add ring sizes and you can approach Shopify’s per-product variant ceiling quickly. We cover how to plan for that in our guide on three checks before you hit 2,048 variants.
You do not have to shoot every combination. A smarter plan:
- Shoot every metal in full. Metal changes the whole piece, so each metal deserves a complete set.
- Shoot stones selectively. If the stone changes only a small element, use one dedicated close-up per stone and share the rest of the angles.
- Skip ring size entirely. Size should never need its own photo. Keep it as an option that does not map to an image.
What Dawn’s ‘hide other variant media’ setting does and does not do
Dawn, Shopify’s free default theme, includes a product setting that hides media attached to other variants once a shopper selects one. It is off by default. When you turn it on, it hides images that are attached to other variants. Images that are not attached to any variant stay visible.
Because only one image can be attached per variant, the setting cannot hide a whole set of photos. If you have seven photos per variant, six of them are unattached in Shopify’s eyes, so they all remain on the page. A merchant in a Dawn GitHub discussion reported exactly this with 42 variants and 7 photos each, and a Shopify developer replied that with one image per variant, it is very hard to build anything sensible.
There is also a modal wrinkle. When a shopper opens the zoom view, hidden variant images could still appear. Dawn’s maintainers addressed that in a pull request that fixed the product media modal, so keep your theme updated if you use this setting.
The takeaway: the native setting is useful when each variant has exactly one distinguishing image and the rest of the gallery is shared, for example a single lifestyle shot that applies to every metal. It is not a gallery filter.
Set up your options so the gallery can follow them
Before choosing a tool, fix the structure. A clean option setup makes every approach work better.
Make metal the primary option
Put metal first: yellow gold, white gold, rose gold, sterling silver, platinum. When a shopper picks rose gold, every photo they see should be rose gold. Metal is the option that changes the most pixels in every image, so it should control the gallery.
Treat stone as a secondary option
Stone choices usually change one part of the piece. Handle them with the variant’s lead image and a dedicated close-up, not a full gallery swap, unless the stone changes the whole look (for example, a colored gemstone with a different overall tone).
Keep option names consistent
Metal names should match exactly across products: ‘14K Rose Gold’ on one page and ‘14k rose gold’ on another will break any rule that relies on matching values. This also affects collection rules and variant mismatches, so standardize before you scale.
Name and order images deliberately
Use file names and alt text that describe the piece, metal and angle. Order the media so each metal’s images sit together. That makes any grouping method, native or app-based, easier to set and audit.
Four ways to show more than one image per variant
When one image per variant is not enough, you have four realistic routes. They differ in cost, fragility and how they behave when you change themes.
| Method | How it works | Best for | Watch out for |
|---|---|---|---|
| Native variant image | One attached image per variant; selecting the option moves that image to the front | Small catalogs, one distinguishing shot | Other photos stay visible |
| Alt-text grouping | A tag in each image’s alt text tells a supporting theme which variant it belongs to | Stores on a theme that reads the tag | Works only in certain themes; one typo is silently ignored |
| Theme-native image sets | The theme uses metaobjects to hold a set of images per option value | Stores on a theme that offers it | Tied to that theme’s setup |
| Variant image app | An app assigns a group of images to each variant or option combination and filters the gallery | Large jewelry catalogs, multi-option products | Monthly cost for some apps; app conflicts |
Alt-text grouping
Some themes read a tag you place in each image’s alt text, then group the gallery accordingly. It costs nothing, but it is fragile. Support is limited to a handful of themes, and a one-character mismatch causes that image to be ignored with no error. If you later change themes, the grouping can revert, because the convention lives in the theme and not in your product data. Treat it as a stopgap, not a foundation.
Theme-native image sets with metaobjects
Some premium themes extend Shopify’s one-image limit with metaobjects. One example is documented in a theme developer’s help center: Ascend Themes explains that Shopify supports one image per variant by default, and its Flawless theme lets you show different image sets based on selected options.
Setup there means creating a metaobject definition with three fields: the product with the option value (single line text), the option value itself (single line text that must match your product’s option value exactly) and the images (a file field that allows multiple values), using the namespace and key flawless.variant_images. Notice the exact-match requirement again. This is why consistent option naming matters.
Variant image apps
For catalogs with many metals and stones, a variant image app is usually the least painful route. The pattern is the same across the category: you assign a set of images to each option or combination, and the storefront shows only what the shopper selected. Some of these apps run on top of Dawn’s existing gallery and across hundreds of other themes, so you keep your layout. Pricing varies by app, and several have a free tier, so compare what each one includes before you commit.
When you evaluate an app, check for these jewelry-specific needs:
- Support for multiple options at once (metal plus stone), not just one.
- Image assignment that survives duplicating a product. See how we handle this in our guide to Shopify product duplication for jewelers.
- Compatibility with your swatch and filter apps, since conflicts are a common cause of broken galleries.
- Behavior on mobile, where most jewelry browsing happens.
- What happens to your assignments if you uninstall or switch themes.
Photography that makes variant images work
The best setup still fails if the photos are inconsistent. A few habits pay off.
- Match the angle and crop across metals. When a shopper toggles from yellow to white gold, the piece should stay in the same position and scale, so only the metal changes.
- Include one macro close-up per metal. A tight shot of the stone in its setting is where color differences are easiest to see, and it builds confidence that the shopper will get what they see.
- Add a scale shot. A hand or neck photo helps with size expectations. If it only exists for one metal, say so in the listing or shoot it for every metal.
- Think beyond stills. Spin views and short clips help, but remember Shopify variants do not carry video, so you will place those in the product gallery. Our posts on 360 jewelry photography and what counts as a jewelry product video go deeper on both.
If you are a retailer who sources from vendors, the vendor’s image set determines how much of this you can offer. Our product listing guide for retail buyers shows what complete vendor data should include.
A step-by-step workflow for a new jewelry product
- Define options. Metal first, then stone, then size. Use identical names across all products.
- Plan the shot list. Full set for each metal, one close-up per stone, no photos for size.
- Upload and order media. Group images by metal, with each group’s first image being the hero for that metal.
- Assign the lead image to every variant in the Variants section of the admin.
- Choose your method. If your theme supports image sets, use it. Otherwise add an app. If your catalog is tiny, the native setting may be enough.
- Test every combination on desktop and mobile, including the zoom view and the add-to-cart button.
- Document the setup so a teammate or a new theme does not undo it.
Troubleshooting: selecting a variant does not change the images
Work through these checks in order:
- Check the assignment. Open the product, go to Variants, click the variant and confirm the Image field is not empty or pointing to the wrong photo. Missing assignments are the most common cause.
- Test with a default theme. Temporarily preview the store on Dawn. If images swap there, your current theme is the issue.
- Disable apps one at a time. Option, upsell and swatch apps can conflict with the gallery.
- Compare option values. If you use a theme or app that matches values, confirm the text matches exactly, including capitalization and spacing.
- Clear caches and check the theme version. Older versions may lack fixes for media behavior.
If a problem remains after these steps, open a ticket with your theme developer or app support, and include a product URL and the variant that fails.
Our perspective
Most variant image problems we see are not photo problems or theme problems. They are data problems. When metal names, stone names and image assignments are inconsistent, every tool downstream, whether a gallery app, a swatch, a collection rule or a feed, has to guess.
That is why we built JewelCloud around structured, standardized jewelry product data. When a product arrives with consistent options and a complete image set for each metal, a retailer can launch a new collection faster and offer richer shopping experiences without rebuilding the catalog by hand. Think of your catalog as a living thing: it needs the same care on the hundredth product as on the first.
Our advice is to fix the structure first, then pick the display tool. A clean foundation lets you change themes or apps later without re-tagging thousands of images.
Anthony
Where JewelCloud fits
If you manage a large assortment, the hard part is not showing one product’s photos correctly. It is doing it consistently across hundreds of styles from many vendors. The JewelCloud Product Feed delivers structured, standardized jewelry data to your store, so options and images arrive organized the same way every time. If you sell custom rings, RingBuilder and our guide to a data-first Shopify ring builder app show how configurators depend on the same clean data.
If your site itself needs rework, our web design for jewelers service and our Shopify web design for jewelry guide cover the design and data decisions together. To see how the platform fits your store, start at JewelCloud.
FAQ
Can I add multiple images to a single Shopify variant?
Not natively. Shopify lets you attach one image to each variant. To show a full set per variant, use a theme that supports image sets, an alt-text convention in a compatible theme, or a variant image app that filters the gallery by selection.
Does Dawn hide all other variants’ images when I select a metal?
No. Dawn’s hide setting is off by default, and when enabled it hides only the one image attached to each other variant. Photos not attached to a variant remain visible, so it will not filter a multi-photo gallery on its own.
Can I put a video or 3D model on a variant?
No. Shopify’s Help Center says variants do not support media types such as 3D models or videos. Add them to the product gallery instead, and keep the lead image assigned to each variant.
Which option should control the gallery on a jewelry product?
Metal, in most cases. It changes the whole piece in every photo. Handle stone with the lead image and a close-up, and keep ring size free of images so you do not multiply your photo count.
Why does my variant image not change when I click an option?
Start with the Image field on the variant in the admin. If it is empty or wrong, fix it. Then test on a default theme and disable option or swatch apps one at a time to find a conflict.
Sources
- Shopify Help Center: Adding images to product variants
- Shopify Dawn GitHub issue #456: Hide other variants’ media
- Shopify Dawn GitHub pull request #1985: Variant media modal fix
- Ascend Themes help center: Show specific images based on variant selection
- Why Jewellery Photos Look Different Online