Overview
In October 2025, Shopify raised its per-product variant limit from 100 to 2,048, one of the biggest platform changes in years. This glossary article explains what that number means, which technical requirements you need to meet, and who benefits most from the increase. It also covers the 3-option cap that still applies, performance considerations for large variant sets, and how bundle builders like Biscuits Bundles relate to this change.
Contents
What is the Shopify variant limit?
The Shopify variant limit is the maximum number of purchasable versions (variants) a single product can have. The product variant limit has officially been raised from 100 to 2,048 variants per product. Each variant represents a unique combination of options like size, color, or material, and carries its own SKU, price, and inventory count. Variants are the unique combinations of those options (e.g., Red / Large / Cotton), and inventory, SKU, barcode, price, and fulfillment happen at the variant level.
For years, 100 variants was the hard ceiling for every Shopify store, regardless of plan. For years, going above 100 variants has been one of the most requested features from merchants with complex catalogs. The new 2,048 limit is available to all Shopify plans and requires no extra configuration in most cases; you simply add more variants to your products in the admin.
How the 2,048 variant limit works in Shopify
Shopify updated the GraphQL Admin API in April 2024, releasing a new version of the product APIs that supported 2,048 variants. This kicked off a massive ecosystem migration. More than 6,500 app partners migrated to the new APIs, ensuring the entire Shopify ecosystem is ready to support complex products.
To take advantage of the higher limit, your store needs a few things in place:
An Online Store 2.0 theme: An Online Store 2.0 theme updated for large variant sets is required. Third-party themes may vary in support, so check with your theme developer.
Modern API integrations: The 2,048 variant limit is powered by Shopify's new GraphQL Product APIs. If your store relies on custom apps or legacy themes that still use the REST Admin API, you may find that those systems are still locked to the old 100-variant limit.
250-media cap: Shopify currently limits products to 250 media items (images, videos, or 3D models). If you have 2,000 variants, you cannot have a unique image for every single one.
Tip - Create a test product with over 250 variants on a staging theme before consolidating your live catalog. This surfaces any theme or app incompatibilities early.
Who benefits most from 2,048 variants
Apparel and fashion
This is common for apparel companies, where products are often merchandised in countless sizes and colors. For example, a bra brand offering 20 colors across 10 band sizes and 5 cup sizes previously had to split listings; now, those 200+ combinations fit under one product.
Furniture and home goods
Furniture companies often offer items that come in multiple sizes, colors and materials, quickly blowing past the 100-variant limit. A sofa available in 8 fabrics, 6 colors, and 3 sizes (144 variants) was already pushing the old cap. Adding a fourth fabric line no longer requires splitting the product.
Customizable and configurable products
Businesses in the fashion and apparel, furniture, and print-on-demand sectors would really benefit from the increase in Shopify's product variants limit. Any merchant offering made-to-order or build-your-own products with a predictable set of configurations can consolidate what was previously spread across multiple listings.
The 3-option limitation that still exists
While the variant cap jumped 20x, one restriction did not change. Shopify has not increased the number of options per product; it still remains limited to 3 options per product. Options are the attribute categories you assign to a product (for example: Size, Color, and Material).
With three options, the math caps out quickly. For catalog listings with three product options, you can enter around 12 and 13 values per option to stay within 2,048 (since 13 × 13 × 12 = 2,028). If you need four or more option categories, you will still need workarounds like third-party apps or combined listings.
Side note - The developer community has been vocal about wanting 4+ options. Shopify has acknowledged it is something frequently asked for, but currently does not have a timeline on if or when this would roll out.
Performance considerations for large variant sets
More variants per product means more data per page load. Themes will not always load every variant. To protect performance, Shopify restricts product.variants in Liquid to 250 and recommends new design patterns for high-variant products. Any code that currently loops over all variants may miss data beyond the 250th variant.
You should render variant pickers efficiently, defer loading of variant data and images, and avoid loading the full variant payload upfront. Lazy-loading variant data through Shopify's Section Rendering API or the Storefront API is the recommended approach for products with hundreds of variants.
Shopify's update improves backend performance, but merchants must still ensure front-end efficiency. Thousands of variants can stress theme logic, so test variant selectors, image loading, and mobile UX carefully.
How this change interacts with bundles
Bundles and variants intersect in two important ways. First, Shopify's native bundle architecture uses variants to represent bundle combinations. A bundle can have up to 30 components and bundles can have up to three options. Second, mix-and-match bundles can generate enormous variant counts; a "pick any 3 from 8 fragrances" box creates 512 possible combinations, which the old 100-variant limit could not handle.
The 2,048 limit helps fixed bundles with predictable option sets fit neatly into Shopify's native bundle model. But truly open-ended mix-and-match bundles (where customers choose from dozens of items across multiple steps) still blow past 2,048 quickly. Choosing 4 items, each in 7 sizes, leads to 2,401 combinations. Choosing 3 items, each in 3 colors and 5 sizes, results in 3,375 combinations. Choosing 6 items, each in 10 flavors, would create 1,000,000 combinations.
This is where dedicated bundle builder apps remain essential. Biscuits Bundles sidesteps the variant limit entirely by building on the Shopify Bundles platform with a multi-step builder interface. Customers walk through collapsible accordion steps to pick products, rather than selecting from a single variant picker. Each component product keeps its own inventory and variants, so you can offer complex mix-and-match experiences without worrying about how many combinations exist. You can see this in action on the Biscuits Bundles demos page.
Tip - If your bundle has a small, fixed set of options (say, 3 sizes × 4 flavors), the new variant limit may be enough on its own. If customers can pick freely from a large catalog, use a bundle builder app instead.
Why the variant limit matters
Consolidating all your product variants onto a single page delivers significant business benefits. It creates a seamless shopping experience and a powerful marketing asset. By using a single product detail page, you concentrate all your efforts from SEO, ad spend, and social marketing onto one canonical URL. This means better search rankings and more efficient campaigns.
Beyond SEO, the operational benefits are tangible. Merchants developed creative solutions over the years to work around the 100-variant limit, including splitting a single product across multiple product pages, custom development, or using third-party apps to stitch listings together on the storefront. These approaches created friction, adding setup costs, complexity, and ongoing management overhead. Eliminating those workarounds saves time and reduces the chance of inventory sync errors.
For merchants evaluating whether to consolidate split products: audit your catalog for items that were artificially separated. Look for products that were split into multiple listings due to the old 100-variant limit. You can now merge these into a single product page, which will clean up your catalog and improve SEO by reducing duplicate listings.
Related concepts
Product options: The attribute categories (e.g., Size, Color, Material) that define your variants. Still limited to 3 per product.
Combined Listings: A Shopify feature that lets you give each variant its own media gallery and description while keeping everything under one product. Useful when your 2,048-variant product needs distinct imagery per colorway.
GraphQL Admin API: The modern API Shopify rebuilt to support the higher variant limit. Required for any app or integration that manages products with more than 100 variants.
Shopify Bundles: The native platform for creating product bundles in Shopify. Apps like Biscuits Bundles build on this platform to offer advanced mix-and-match experiences that go beyond what variant combinations alone can represent.
Online Store 2.0: Shopify's modern theme architecture that supports app blocks and is required for full 2,048-variant functionality.
Section Rendering API: A Shopify API that lets themes load variant data asynchronously, which is critical for product pages with hundreds of variants.
View on app store