Shopify variant and image limits explained
Shopify variant image limits are where visual merchandising runs headfirst into platform rules. Two ceilings matter: 100 variants per product by default (2,048 with Combined Listings) and 250 images per product, full stop. If you sell apparel, cosmetics, furniture, or anything with multiple colors and sizes, you will hit at least one of these ceilings sooner or later.
This post is the practical explainer we wish every merchant had before they started uploading images. We cover exactly what the limits are, how variant images behave inside those limits, when the limits hurt, and how to get the most out of your 250 image budget before you need to split the product.
We also explain when to pair Rubik Variant Images with Combined Listings. The short version: RVI filters gallery images per variant on the product page, and Combined Listings splits the catalog into linked products when the 250 image ceiling stops being enough. Two tools, two jobs, one clean setup.
Table of contents
- The limits at a glance
- How the 100 variant limit works
- How the 250 image limit works
- Variant images inside the 250 image budget
- When you hit the wall
- How RVI helps inside the limits
- When you need Combined Listings
- Worked examples
- FAQ
The limits at a glance
| Limit | Default | With Combined Listings | Notes |
|---|---|---|---|
| Variants per product | 100 | 2,048 effective | Works on every plan since 2024 |
| Images per product | 250 | 250 per linked product | Hard limit inside one product |
| Options per product | 3 | 3 per linked product | Hard in the admin |
| Image file size | 20 MB | Same | Per image |
| Image resolution | 4472 x 4472 | Same | Max pixels |
Two of the five rows bend with Combined Listings. The others are hard.
How the 100 variant limit works
Shopify caps variants at 100 per product in the default admin. A shirt with 10 colors and 10 sizes is exactly 100 variants. Adding one more color fails to save with an error about the variant limit.
In 2024 Shopify raised the effective ceiling to 2,048 by introducing Combined Listings. This is not a single product change. It is a linking feature. You create multiple separate products, each with up to 100 variants, and link them into one shopping experience. The admin counts variants per product, not per group, which is why the math works.
The key point for image planning: each linked product still has its own 250 image budget. More on that below.
How the 250 image limit works
250 images per product is a hard limit. There is no Shopify plan that raises it, there is no app that raises it, and there is no workaround inside a single product. Once you upload image 251 the admin rejects it.
This is the limit that hits visual categories hardest. Furniture stores with multiple angles per fabric. Cosmetics lines with swatch photography per shade. Apparel with model photography per color. All of them chew through the 250 budget fast.
Variant images inside the 250 image budget
Every image you attach to a variant counts against the same 250 total. A 100 variant product where each variant has 3 photos is 300 images, which is already over the ceiling. In that case you either trim images per variant or split the product.
Inside the budget, variant images behave in a specific way. Shopify assigns one “featured” image per variant natively. The rest of the gallery is shared across variants by default. When a shopper picks a color, the native theme jumps to the one featured image, but the rest of the gallery stays mixed.
That default behavior is what Rubik Variant Images fixes. With RVI you can attach multiple gallery images to a single variant and filter the gallery to show only those images when the variant is picked. You still live inside the 250 image budget, but you use it far more effectively.
When you hit the wall
You hit the variant wall when your product math crosses 100. 10 x 10 crosses it. 12 x 9 crosses it. 5 x 5 x 5 crosses it.
You hit the image wall when your photography plan crosses 250. 20 colors x 13 angles per color is 260, wall hit. 30 shades x 9 photos is 270, wall hit. 50 fabrics x 6 angles is 300, wall hit.
Both walls show up with clear admin errors, not silent failures. That is the good news. The bad news is that the admin does not suggest a fix.
How RVI helps inside the limits
Rubik Variant Images does not raise the 100 variant limit. It does not raise the 250 image limit. What it does is help you use those two budgets to their maximum before you need to split.
Three things matter:
- Assign multiple images per variant. Go beyond the one featured image per variant that Shopify gives you natively. Attach 3, 5, 10 images to a single color, and RVI will filter them in.
- Filter the gallery when a swatch is clicked. Shoppers see only the images that belong to their color. Cleaner visual story, fewer dead scrolls, higher conversion.
- Custom swatches on the product page. Color, image, or text swatches with your own shape and style. The swatch clicks drive the gallery filter.
RVI is product page only. It is metafield based, no external API calls, so it loads with the page itself. It does not touch collection pages. If you also want swatches on the collection grid, that is Combined Listings territory.
Our theme setup guides cover the exact install steps for Dawn, Craft, Sense, Impulse, Prestige, Pebble, and more. The AI auto assign guide walks through getting RVI to analyze a product and place images automatically. The bulk assign guide covers gallery order based grouping across hundreds of products at once.
When you need Combined Listings
RVI stops being enough when your math blows past the 250 image budget or the 100 variant ceiling, not when it strains against them. The signals:
- You cannot fit all the photos you need for your colors inside 250 images.
- You cross 100 variants because of a fourth dimension (fit, material, length).
- You want each color to rank on its own Google page with its own URL and title.
- You want swatches on the collection page so shoppers can switch variants before clicking in.
All four of these are Combined Listings jobs. Rubik Combined Listings lives on our sister site. It lets you split a catalog into several linked products so each keeps its own 100 variant and 250 image budget while presenting to shoppers as one experience. Read the full breakdown at how Combined Listings bypass Shopify limits.
For the broader platform picture, the Shopify limits 2026 mega guide covers every hard and soft limit on the platform.
Worked examples
Apparel brand, 8 colors x 5 sizes, 6 photos per color. 40 variants, 48 images. Fits cleanly in one product. Use RVI to filter the gallery when a color is picked. No need for Combined Listings.
Cosmetics line, 30 shades x 2 finishes, 4 photos per shade. 60 variants, 120 images. Still fits. RVI alone. Perfect case.
Apparel brand, 12 colors x 10 sizes, 3 photos per color. 120 variants, over the 100 variant limit. Split into 2 linked products by a sub dimension, or by color group. Use Combined Listings for the linking and RVI inside each product for gallery filtering.
Furniture store, 20 fabrics x 5 frames x 4 legs, 10 photos per fabric. 400 variants, 200 images per fabric times 20 fabrics is way over 250. Split by frame into 5 linked products with Combined Listings. Inside each product, RVI filters the gallery by fabric.
Comparison: what each tool does about the limits
| Need | RVI alone | Combined Listings | Both together |
|---|---|---|---|
| Filter gallery per variant on product page | Yes | No | Yes |
| Swatches on product page | Yes | For grouped products | Yes |
| Swatches on collection page | No | Yes | Yes |
| Link separate products into one experience | No | Yes | Yes |
| Bypass 100 variant limit | No | Yes | Yes |
| Fit more images than 250 (across group) | No | Yes | Yes |
Related reading
- Shopify limits 2026 complete guide
- How Combined Listings bypass Shopify limits
- AI auto assign variant images
- Bulk assign variant images by gallery order
- Theme setup guides
- Variant image troubleshooting
FAQ
What is the maximum number of variants per Shopify product? 100 by default. Up to 2,048 effective variants using Combined Listings to link separate products, available on every plan since 2024.
What is the maximum number of images per Shopify product? 250 images per product. This is a hard limit on every plan and cannot be raised inside one product.
Do variant images count against the 250 image limit? Yes. Every image attached to a variant comes out of the same 250 budget.
Can Rubik Variant Images raise the 250 image limit? No. RVI helps you use the 250 budget more effectively by filtering the gallery per variant. For more than 250 images total, split into linked products with Combined Listings.
Does RVI work on collection pages? No. RVI is product page only. Swatches on collection pages are the job of Rubik Combined Listings.
Do I need Shopify Plus to go beyond 100 variants? No. Combined Listings on any plan gives effective 2,048 variants.
Can I use RVI and Combined Listings together? Yes. This is the recommended setup for stores with many colors. RVI handles the product page image filtering. Combined Listings handles the collection page swatches and the linking.
How does RVI load on the product page? Metafield based, no external API calls, it loads with the page itself.
Will splitting a product into a group hurt SEO? Usually the opposite. Each linked product gets its own URL, title, and images.
Is there a file size limit for variant images? Yes, 20 MB per image and 4472 x 4472 pixel maximum.
Use your 250 image budget the right way
Before you worry about splitting products, make sure you are using your 250 image budget cleanly. Install Rubik Variant Images to assign multiple images per variant and filter the gallery when a swatch is picked. When you truly outgrow 250 images or 100 variants, pair it with Combined Listings for the split.
