We tried to add one more option to a shopify product to get across its variant limit and things broke. Everthing looks normal and good, except for poorly-written error messages. Sadly, the official shopify docs don’t go into detail about what actually happens behind the scenes, and only very briefly describe the resulting error messages.
I’ll go through each error shopify can throw, as well as the exact cause and work around for each error.
In this post
- The 3 walls you can hit
- Error: variant limit exceeded (2048)
- Error: too many options
- Error: image limit reached (250)
- What CSV import does
- The real fix
- FAQ
The 3 walls you can hit
Shopify has a variety of restrictions in place, all commonly referred to as the “variant limit”. Actually, there are three hard ceilings in place.
- 2048 variants per product. The variant row count.
- 3 option types per product. The dimension count (color, size, material, etc.).
- 250 images per product. The media gallery cap.
You can hit all of these at once. Error messages may look different. Fixes are different. Treat each separately.
Error: “Variant limit exceeded” (the 2048 wall)
The admin interface will display a message on the variants table noting a product cannot have more than 2048 variants. The Variant count exceeds product limit of 2048 error will also be raised on the Variantable API’s productSet and productVariantsBulkCreate mutations.
When it happens: You want to make a product with 20 colors, 15 sizes, and 10 materials. That equals 3000 variations, which is 952 variations over the cap.
How to fix: split the product. Take one option dimension (usually the one with fewest shared images, like material) and make it a separate sibling product. Then list all of the sibling products together. Done.
Error: “Product can have at most 3 options”
Intuitive Interface: What you see: Product can have at most 3 options. Full stop. No exceptions. Plus plans included.
When it happens: You want to add a 4th option such as “engraving” or “length” to complement the existing options of color, size and material. Shopify blocks you from doing this at the API and admin levels.
How to fix: 10. Merge two similar options together into one option listing (e.g. material + finish = “Material – Oak Matte”, “Material – Oak Gloss”, etc.) – or use combined listings to list in multiple products. 10. A product personalizer app – use a 4th dimension for customization (i.e. not inventory).
Error: image limit reached (250)
After uploading 250 images, admin stopped accepting any more. Getting error Media count exceeds product limit when trying through API.
When it happens: The product creates images for a product with 30 colors and 10 product views per color for a total of 300 images. The 250 cap hurts. This wall height was NOT increased at the same time as the variant cap which is ridiculous seeing as there are now 2048 variant options and only 250 images are allowed. Nobody that I have spoken to at Shopify has admitted to this flaw and will respond otherwise.
How to fix: reduce photos per color, or use shared images across variants, or split the product out into separate listings. This is what the extension Rubik Variant Images is for, as it lets you assign images to more than one variant at a time. So you can assign a lifestyle shot to all the colors of an item.
What CSV import does when you exceed the limit
CSV imports on Shopify store – work differently. If your CSV has 3000 variant rows for a single product handle, Shopify’s importer will
- Import the first 2048 rows successfully
- Log the remaining 952 rows as errors in the import report
- NOT tell you clearly that you are capped (the error is buried)
Matrixify does the same transformation but with more informative error messages. Make sure to review the import report. Always.
The real fix: combined listings + variant image filtering
Whatever wall you hit, the answer usually involves two things: splitting the product and filtering images. We’ve got combined listings for splitting, as well as variant image filtering for the gallery.
See Rubik’s live demo, go through the tutorial, and documentation if you want to skip the trial and error.
Quick reference: Shopify product limits
| Limit | Value | Error message | Fix |
|---|---|---|---|
| Variants/product | 2048 | Variant count exceeds product limit | Split via combined listings |
| Options/product | 3 | Product can have at most 3 options | Combine or split |
| Images/product | 250 | Media count exceeds product limit | Share images across variants |
| Products/store | No limit | N/A | N/A |
| SKUs/store | No limit | N/A | N/A |
Map your limits before you build. Use our variant calculator and SKU generator.
FAQ
What error does Shopify show when you exceed 2048 variants?
“Variant count exceeds product limit of 2048” via API, or red banner in admin.
Does Shopify delete variants if I exceed the limit?
No. The save is rejected entirely. Your existing variants stay intact.
Why wasn’t the 250 image cap raised alongside variants?
Why is this? Shopify hasn’t publicly explained this. Likely related to CDN cost and theme rendering.
Can I bulk import past 2048 via CSV?
No. The importer silently drops rows past 2048 and logs errors.
Does Shopify Plus have a higher cap?
No. All plans are capped at 2048 variants, 3 options, 250 images per product.
What’s the fastest workaround?
Use Multiple Sources in One Search Results Page. Install Rubik Combined Listings to help you achieve this. Relatively straightforward to set up, about 15 minutes to set up per product (assuming you split the product out and set up separate groups for the combined listings).
Do apps like Rubik require Shopify Plus?
No. Rubik apps work on every plan, including Basic.
Related reading
- 2048 variant limit explained
- 3 option type workarounds
- Bypass variant limit without Plus
- Combined listings bypass (rubikify.com)
- Rubik Variant Images site
If this is being read at 2am because of an error similar to the one I experienced, rest assured – everything will be alright. Shopify did not lose the data. Simply change the product from a dropdown to a separate section and group the content. You should be good to go in an hour.
