Shopify Prestige theme variant images: complete setup guide (2026)

Prestige is the premium Maestrooo theme that fashion and luxury brands gravitate toward. Beautiful out of the box. But the variant image setup is a quiet stumbling block. Prestige does support multiple images per variant natively, in a way most themes do not, but it uses an alt-tag hashtag convention that is poorly documented and brutally fragile if you have more than 30 products. Color swatches are the same: native support exists, but the configuration takes work, and the image swatch path is not obvious.
This guide walks the entire Prestige variant story end to end: variant image sets, color swatches, image-based swatches, multiple images per variant, out-of-stock handling, collection page swatches, and combined listings on Prestige. We mark which parts the theme handles natively and which parts you need an app for, with honest notes on when each path makes sense.
Quick disclosure: we make Rubik Variant Images and Rubik Combined Listings. Both work on Prestige. We will mention them where they actually save time. For small catalogs, Prestige’s native features are usually enough; we will tell you when that is the case.
In this post
- What Prestige supports natively (and what it does not)
- Variant image set: the alt-tag hashtag method
- Multiple images per variant on Prestige
- Color swatches: native setup
- Image-based swatches (textures, patterns, fabric)
- Out-of-stock variant handling
- Color swatches on collection pages
- Combined listings on Prestige
- When the native Prestige features fall short
- Common Prestige variant issues and fixes
- Frequently asked questions
- Related reading
What Prestige supports natively (and what it does not)
The honest summary, before diving in:
| Feature | Prestige native | Notes |
|---|---|---|
| Color swatches on product page | Yes | Auto-detects standard color names; manual mapping for custom names |
| Color swatches on collection page | Partial | Theme setting toggle; depends on Prestige version |
| One image per variant | Yes | Standard Shopify behavior |
| Multiple images per variant | Yes (Prestige v7+) | Uses alt-tag hashtag method (manual, fragile at scale) |
| Image-based swatches | No | Requires custom code or app |
| Hide out-of-stock variants entirely | No | Greys out by default; full hide needs CSS |
| Linking separate products as one | No | Combined listings native is Plus only; otherwise needs app |
| Customizable swatch shapes | Partial | Round and square; custom shapes need CSS |
The headline insight: Prestige is one of the few themes that supports multiple images per variant out of the box. That is rare and worth using if your catalog is small. For large catalogs, the manual alt-tag workflow becomes painful fast, and an app saves real hours.
Variant image set: the alt-tag hashtag method
This is the Prestige-specific feature that is buried in Maestrooo’s docs and trips up most merchants. Here is how it works.
- Identify which option drives the image change (usually Color, but it could be Pattern, Material, Scent, anything).
- Upload all your images to the product gallery as normal.
- For each image, edit the alt text. Open the image in Shopify admin and set the alt tag using this exact format:
#option_name_option_value. Notice the hash, the option name, the underscore, and the option value. - Example: for a “Red” variant of the “Color” option, the alt tag is
#color_red. For “Olive Green,” it is#color_olive_green(spaces become underscores). - Repeat for every image you want associated with that variant. Multiple images with the same hashtag all belong to the same variant set.
- When the customer selects “Red,” Prestige filters the gallery to show only images tagged
#color_red.
Available in Prestige v7 and higher. If your theme is older, update first. Maestrooo provides the version under Theme settings > Theme info.
Three caveats to know:
- The hashtag is case-insensitive but spelling-sensitive.
#color_olive_greenmatches “Olive Green” but not “olivegreen” or “Olive-Green.” Pick one canonical spelling and stick with it. - This method overwrites the image’s actual alt text for accessibility. The hashtag becomes the alt. If SEO and screen-reader semantics matter to you, this is a tradeoff to weigh.
- For a 200-product catalog with 6 colors and 4 images per color, you are typing 4,800 alt tags. That is genuinely brutal. Apps automate this; alt-tag manual is fine for under 50 products and miserable above 200.
Multiple images per variant on Prestige
Combine the alt-tag method with multiple images per color and you have full multi-image-per-variant on Prestige. Lifestyle plus on-white plus detail shot, all linked to the same color, all filtered by the variant picker.
The workflow:
- Upload 3 photos of the red variant (lifestyle, on-white, detail).
- Tag all 3 with
#color_red. - Repeat for blue, green, etc.
- Customer selects red, gallery shows the 3 red images.
For our app-driven approach to the same outcome (with no manual alt tagging), see our multiple-images-per-variant approach (Horizon-titled but the workflow applies on Prestige too with Rubik Variant Images installed). The app uses gallery order with featured-image boundaries to define which media belong to which variant, so you upload images in groups and skip the alt-tag work entirely.
Color swatches: native setup
Prestige ships with built-in color swatches. The default is to auto-detect colors from option values that match standard CSS color names (“Red,” “Blue,” “Black”). For custom names (“Midnight Sky,” “Coral Rose”), you have to map them manually.
- Open theme editor > Theme settings > Swatches.
- Add a row for each custom color name. Set the value (must match your option value exactly) and the hex code or color picker.
- Save.
- On the product page, also confirm Variant Picker is set to Block with display style Swatch.
- Per-product, in the product settings panel, confirm Enable color swatches is checked.
That fifth step trips up most merchants. Prestige requires both the global theme setting and the per-product enablement. If you only do one, no swatches show.
For deeper customization (shapes, sizes, hover states), see our existing Prestige color swatches setup guide.
Image-based swatches (textures, patterns, fabric)
For variants where a hex code does not capture the look (a leopard print, a tweed fabric, a marbled pattern), you want image-based swatches. Each swatch is a small thumbnail of the variant’s actual texture.
Prestige does not natively support image swatches without code edits. Two paths:
- Custom code path. Edit
main-product.liquidandproduct-form.liquidin your theme to render<img>elements for each swatch using the variant’s image as the source. Add CSS to style as small circular or square swatches. This is around 50 to 80 lines of Liquid plus CSS, manageable for a developer, fragile to maintain across theme updates. - App path. Rubik Variant Images renders image swatches on Prestige (and 350+ other themes) without theme code. Set the option to image swatches in the app, upload the swatch images per variant, save. Done in five minutes.
If you sell anything with patterns, fabrics, prints, or textures (apparel, home decor, accessories), the app path is usually the right call. Custom code becomes a liability the first time Maestrooo ships a Prestige update and your edits get out of sync.
Out-of-stock variant handling
Prestige’s default behavior: sold-out variants render with a strikethrough. Customers see the option but cannot click it. For most stores this is fine. The complications:
- The first variant gets auto-selected. If your “Small” or “Black” sells out, Prestige still picks it as the default, and the page lands with a greyed-out Add to Cart. To pre-select the first available variant, use
product.selected_or_first_available_variantin the relevant Liquid templates (Maestrooo support can patch this for paying theme customers). - To fully hide sold-out variants instead of strikethrough, add CSS:
.product-form__input--swatch:has(input[disabled]) { display: none; } - To handle this systematically across products, custom Liquid is the clean fix. Many variant-picker apps also offer an “auto-select first available” toggle as part of their variant logic.
Color swatches on collection pages
Prestige supports color swatches on collection page product cards through the theme settings, but the implementation is limited:
- Native swatches show as small dots under the product card.
- Clicking a swatch on the card does not change the card’s image to the matching variant in older Prestige versions. Hover sometimes works, click usually does not.
- For full collection page swatch behavior (click changes the card’s product image, with smooth transitions), Rubik Combined Listings handles this on Prestige along with linking separate products into combined groups.
Our deeper read: collection page color swatches and product cards.
Combined listings on Prestige
If your store has separate products per color (common in apparel and POD), Prestige does not natively merge them into combined listings. Native combined listings is a Shopify Plus feature only. For Basic, Grow, and Advanced merchants on Prestige:
- Use Rubik Combined Listings to link separate products as one group, with swatches on both the product page and the collection page. Works on Prestige out of the box.
- Bulk grouping in the app uses title patterns (your products named “Sarah Bra – Olive” / “Sarah Bra – Black” auto-group), product tags, or shared metafields. Hundreds of products groupable in one batch.
- SEO benefit: each color keeps its own URL, title, and images, so individual color pages still rank for “olive bra” type queries while the combined parent ranks for “Sarah Bra.”
Why does this matter on Prestige specifically? Because Prestige stores tend to be premium fashion and luxury, where the catalog is often structured as separate-product-per-color (each color photographed, named, and SEOed independently). Combined listings preserves that SEO setup while giving customers the unified shopping UX.
When the native Prestige features fall short
Prestige’s native variant features cover the basics. The path-of-least-resistance app upgrade typically makes sense in these cases:
- Catalog over 100 products with multiple colors. The alt-tag method becomes unworkable. App auto-assignment is way faster.
- You want image swatches for textures or patterns that hex codes cannot capture.
- You sell separate products per color and want a unified product page UX.
- You want clickable color swatches on collection pages that actually change the product card image.
- You want videos or 3D models per variant, not just images. Prestige’s alt-tag method only works on images.
For everything below those bars, native Prestige is enough. We have seen plenty of Prestige stores running entirely on the alt-tag method with a 30-product catalog and zero issues. Match the tool to the catalog size.
Common Prestige variant issues and fixes
- Variant images not switching when I click a swatch. Likely cause: alt-tag mismatch. Check spelling, underscores, and hash.
#color_rednot#Color_Rednot#color-red. - Swatch shows up but with the wrong color. Custom color name not mapped under Theme settings > Swatches. Add the mapping.
- Swatches missing entirely on product page. Two possible causes: variant picker block not set to Swatch display, or per-product “Enable color swatches” checkbox not enabled.
- First variant out of stock and Add to Cart is greyed. Prestige defaults to first variant by index, not by availability. Fix in Liquid (or Maestrooo support patch) by switching to
selected_or_first_available_variant. - Out-of-stock variants showing instead of being hidden. Prestige strikes through but does not hide. Add CSS to fully hide.
- Mobile swatch overflow. When you have 12+ colors, mobile wraps awkwardly. Add CSS for horizontal scroll or grid layout.
- App and theme conflict. Some apps inject their own swatch HTML, which conflicts with Prestige’s. Disable the conflicting app or pick one source of truth.
Frequently asked questions
Does Prestige theme support multiple images per variant?
Yes, Prestige v7 and higher support multiple images per variant via the alt-tag hashtag method. Tag each image’s alt text with #option_name_option_value (for example #color_red) and Prestige filters the gallery to those images when the matching variant is selected. Manual but built-in.
How do I add color swatches to Prestige?
Three steps. First, in Theme settings > Swatches, map your custom color names to hex codes. Second, in the product page template, set the variant picker to Block style with Swatch display. Third, in each product’s settings panel, check “Enable color swatches.” All three are required for swatches to appear.
Can I use image swatches on Prestige without an app?
Not natively. Prestige supports color swatches via theme settings but does not have a built-in image swatch feature. To use textures, patterns, or fabric thumbnails as swatches, you need either custom Liquid edits to main-product.liquid and product-form.liquid, or a third-party app like Rubik Variant Images.
Why are my Prestige variant images not switching on click?
The most common cause is an alt-tag mismatch. The hashtag must follow the exact format #option_name_option_value, with spaces as underscores and lowercase letters. #color_olive_green matches “Olive Green” but #Color-Olive-Green does not. Double-check the alt text on each image.
Does Prestige work with combined listings?
Shopify’s native combined listings is Plus only. For Basic, Grow, and Advanced Prestige stores, third-party apps like Rubik Combined Listings link separate products into one shoppable group with collection page swatches, on Prestige and 350+ other themes.
How do I hide sold-out variants on Prestige?
Prestige strikes through sold-out variants by default but does not hide them entirely. To fully hide, add CSS:
.product-form__input--swatch:has(input[disabled]) { display: none; }
This hides any swatch whose input is disabled (Prestige’s marker for sold-out).
Should I update from Prestige v6 to v7 just for variant images?
If you have customizations, the upgrade is non-trivial because Prestige updates often require redoing custom Liquid edits. If you have no customizations, yes, update to v7+. Multiple images per variant is a meaningful UX improvement that justifies the upgrade. Backup your theme before any major version update.
Related reading
- Shopify Prestige theme color swatches setup guide
- Multiple images per variant on Shopify (the complete guide)
- Collection page color swatches and product cards
- Horizon theme variant button issues complete fix guide
- Shopify Impulse theme variant images
- Rubik Variant Images for Prestige and 350+ other themes
- Rubik Combined Listings for separate-products grouping on Prestige
One last note. Prestige is a premium theme with active Maestrooo support. If you hit a Prestige-specific bug not covered in this post, their support is responsive and worth a ticket. Keep an eye on Maestrooo’s changelog for the latest variant-picker updates.