Shopify raised the per-product variant limit from 100 to 2,048, on every plan, with no upgrade required. Two things did not move with it: a product still caps out at three options, and Liquid's classic product.variants array still shows only the first 250 variants. Both limits catch manufacturers and wholesalers who consolidate a large SKU catalog without checking their theme and integrations first.
For years, a 100-variant ceiling forced Canadian manufacturers with deep color, size, and material matrices to split one product family across two or three separate listings. That workaround is no longer necessary for the variant count itself, but it also is not automatic to undo. Consolidating a catalog now means checking your theme, your PIM and inventory sync, and your SEO structure before you merge anything.
01. The Quick Answer
- What changed: the per-product variant limit went from 100 to 2,048, on every Shopify plan.
- What did not change: the three-option cap, and the 250-variant limit on the classic Liquid variants array.
- Who this affects most: manufacturers and wholesalers with deep color, size, or material matrices who previously split one product across multiple listings.
- What to check first: your theme's variant rendering, and any inventory, pricing, or PIM app older than this change.
- What not to do: merge listings manually without mapping SKUs, redirects, and variant IDs first.
02. What Actually Changed
Shopify increased the maximum number of variants a single product can hold from 100 to 2,048, a twenty-fold jump. The change applies uniformly, from the Basic plan through Shopify Plus, so it is not a feature you unlock by upgrading. A product with color, size, and material options that previously had to stop at 100 combinations can now represent its full matrix in one listing.
Why it matters: this removes the single biggest reason manufacturers and wholesalers used to split one product family into multiple near-duplicate listings. A single SKU line no longer has to fragment across two or three product pages purely to fit under the old ceiling.
03. The Limits That Did Not Move
| Factor | Before | Now |
|---|---|---|
| Variants per product | 100, on every plan | 2,048, on every plan |
| Options per product | 3 maximum | Still 3 maximum, unchanged |
| Variants shown via Liquid | product.variants returns up to 100 | product.variants caps at the first 250 in Liquid |
| Media items per product | 250 images, videos, and 3D models combined | Still 250, unchanged |
| Plan required for the higher count | Not applicable | None, available on Basic through Plus |
Why it matters: the headline number, 2,048, is the easy part to celebrate. The three-option cap and the 250-variant Liquid ceiling are the parts that actually determine whether a consolidated product works correctly on your storefront, and they are easy to miss if you only read the changelog headline.
04. Why This Matters for Manufacturers and Wholesalers
Deep variant matrices are the norm, not the exception, for manufacturers and B2B sellers. Fasteners in multiple finishes and sizes, apparel in color and size, packaging in size and material, all of these routinely exceeded 100 combinations and had to be split into separate listings that each carried their own reviews, their own URL, and their own competing SEO signal for what was really one product family.
Why it matters:consolidating those split listings into one product concentrates search authority, simplifies the buyer's path on a wholesale catalog or quick-order grid, and reduces the number of places your team has to update pricing and inventory. It is a real structural cleanup opportunity, not just a technical footnote.
05. Signs Your Store Needs a Review Before You Touch This
- Your theme was built on the classic product.variants Liquid array. If a product page, quick-order grid, or Buy Button loops through product.variants directly, it will only ever show the first 250 variants, no matter how many the product actually has. Anything past that count is invisible to shoppers and to your own storefront search.
- You run inventory, pricing, or PIM sync apps older than this change. Integrations written against the old REST variant endpoints or a 100-variant assumption can time out, paginate incorrectly, or apply a bulk price update to only part of a large variant set. Test on a duplicate product before trusting a sync job against a live 2,048-variant catalog.
- You maintain near-duplicate product listings to work around the old cap. A common pattern under the 100-variant ceiling was splitting one product family, such as a fastener line in multiple finishes and sizes, across two or three separate listings. Each listing under the old cap now fits inside a single product, but consolidating requires a real migration plan, not a manual copy-paste.
- You need a fourth attribute, like pack size, alongside color, size, and material. The three-option cap did not move. A fourth dimension still needs a second product, a linked product group, or a metafield-driven configurator layered on top of the standard variant picker.
Why it matters: any one of these signs means a straight merge of your split listings will break something, whether that is a storefront that hides variants past 250 or a sync job that mis-prices half a catalog. Catching this in a review is far cheaper than catching it after go-live.
06. How to Consolidate Safely
- Audit which product families were split by the old 100-variant cap. Pull a list of products that share a title pattern, description, or SKU prefix across two or more listings. Those are the strongest consolidation candidates, since the split was almost always the variant ceiling, not a real merchandising choice.
- Confirm your theme can render past variant 250. Check whether product pages, filters, and any quick-order or B2B catalog view rely on the classic Liquid variants array. If they do, plan a theme update to the newer paginated variant queries before you merge listings that will exceed 250 variants.
- Test every inventory, pricing, and PIM integration on a duplicate product first. Clone one high-variant-count product, push it past 250 and then past 1,000 variants in a staging or duplicate state, and confirm your ERP, PIM, and pricing sync tools handle the full set correctly before you touch the live catalog.
- Migrate SKUs, redirects, and variant IDs deliberately. Merging listings changes URLs and internal variant IDs. Map old SKUs to their new variant, set 301 redirects from retired product URLs, and update any external system, from your ERP to your ad feed, that references the old product IDs directly.
Why it matters: the order matters here. Auditing before touching the theme, and testing integrations before migrating live SKUs, is what separates a clean catalog consolidation from a broken storefront and a week of support tickets.
07. How AtlanticWorks Helps
AtlanticWorks is a certified Shopify partner working with manufacturers, wholesalers, retailers, and DTC brands across Atlantic Canada, the rest of Canada, and the US. We audit which product listings were split only because of the old variant ceiling, confirm your theme and B2B catalog can render past 250 variants, test your PIM and inventory sync against a high-variant product before go-live, and map the SKU and redirect plan for a clean consolidation. It starts with a free assessment of your current Shopify catalog structure.
08. Key Takeaways
- Shopify increased the per-product variant limit from 100 to 2,048 across every plan, Basic through Plus, with no upgrade required.
- The option cap did not change. A product still combines at most three option types, so 2,048 variants have to fit inside color, size, and material, or whichever three dimensions you choose.
- Liquid's classic product.variants array still returns only the first 250 variants, so a theme or catalog view built on it will silently hide anything past that count.
- Media items stay capped at 250 per product, combined across images, videos, and 3D models.
- Apps and integrations built before this change, especially older REST-based inventory and PIM sync tools, should be tested against a high-variant product before you consolidate a live catalog.
- Consolidating listings that were split only because of the old 100-variant ceiling can clean up SEO and catalog structure, but it changes URLs and variant IDs and needs a planned migration, not a manual merge.
09. Frequently Asked Questions
How many variants can a Shopify product have now?
A single Shopify product can now have up to 2,048 variants, up from the old limit of 100. This applies across every plan, from Basic through Shopify Plus, with no upgrade required to unlock the higher count.
Do I need Shopify Plus to get the 2,048 variant limit?
No. The 2,048 variant limit applies to every Shopify plan, including Basic, Shopify, Advanced, and Plus. This is different from features like carrier-calculated shipping or native B2B, which as of publication remain plan-gated. Variant capacity is the same everywhere.
Can my storefront display all 2,048 variants of a product?
Not through the standard Liquid product object. Liquid still exposes only the first 250 variants of a product, so a catalog page or Buy Button built on the classic product.variants array will silently cut off anything past variant 250. Displaying the full 2,048 requires the newer variant-paginated storefront APIs or a theme rebuilt to fetch variants beyond that window.
How many options can one Shopify product have?
Three. The option cap did not move with the variant increase. A product can combine at most three option types, such as color, size, and material, and the 2,048 variants have to fit inside those three dimensions. A fourth option, such as pack size on top of color, size, and material, still requires a second product or a metafield-based workaround.
Will my existing Shopify apps break with more than 100 variants?
Some will. Apps built against the older REST product endpoints or against an assumption of a 100-variant ceiling can time out, truncate data, or misprice bulk edits once a product passes that count. Apps built on the current GraphQL Admin API are designed for the higher limit, but inventory, pricing, and PIM integrations that predate this change should be tested on a duplicate product before you consolidate a live catalog.
Should a manufacturer or wholesaler consolidate multiple product listings into one now?
Often yes, if the separate listings exist only because of the old 100-variant ceiling and share the same option structure. Consolidating rebuilds one clean product page, one review thread, and one set of SEO signals instead of splitting them across near-duplicate listings. It is not automatic, though. Merging changes URLs, variant IDs, and inventory sync mappings, so it needs a planned migration rather than a manual edit.
Variant, option, and media limits here reflect Shopify's published documentation as of this article's publish date. Shopify changes platform limits periodically, so confirm the current numbers for your store in the Shopify Help Center before planning a catalog migration around them.
Related resources
Keeping a large SKU catalog consistent across channels
Catalogs, pricing, and self-service buying for wholesale
Connecting inventory and orders behind the checkout
Structuring stock across a deep variant matrix
Still running split product listings from the old variant cap?
AtlanticWorks runs a free assessment that reviews your catalog structure, checks whether your theme and integrations can handle the new variant limit, and maps a safe consolidation plan if one makes sense for your store.
Start the Assessment