Add to Preferred Sources
The Shopify product variants limit is currently 2,048 variants per product — a significant increase from the previous cap of 100, available to all merchants on all plans since Shopify's October 2025 rollout. The Shopify variant limit 2048 upgrade applies to every plan tier at no additional cost.
If you have been splitting products to work around the old 100-variant ceiling, you can now consolidate. If you are planning a catalogue for a fashion, homeware or custom-gift store in South Africa, this guide shows you exactly where the real constraints sit — because 2,048 variants is not the number most SA operators will hit first.
The constraint that catches most SA clothing and accessories stores is not the variant total — it is the Shopify product options limit of three dimensions per product, which was not changed in the 2025 update. Once you understand both limits together, catalogue planning becomes a straightforward calculation. See our broader guide to Shopify product bundles for SA businesses if you also need to package variants across products.
Quick Answer
The Shopify product variants limit is 2,048 variants per product across all Shopify plans, effective October 15, 2025. Each product is still limited to three option types (e.g. Colour, Size, Material). The number of values per option is not capped by Shopify, but the product of all option values cannot exceed 2,048. If your product needs four or more option dimensions, you will need a workaround — line item properties, a third-party options app, or product splitting.
In This Guide
Option-combination decision table
SA store types that hit the limit fastest
Not sure how to structure your Shopify catalogue?
Send us your product list and we will map the right variant structure — including where options apps and product splits make sense for your range.
Get a free catalogue reviewHow the Shopify Product Variants Limit Works
Shopify's 2,048-variant limit is the maximum number of option-value combinations a single product can hold — calculated by multiplying the number of values in each option type together. A product with Colour (Red, Blue, Green) and Size (S, M, L) creates 3 × 3 = 9 variants; the ceiling is reached when that multiplication hits 2,048.
Three rules govern every product:
- Variants per product: up to 2,048
- Options per product: up to 3
- Values per option: no stated limit — but the product of all option-value counts must stay at or under 2,048
All plans, same limit. The 2,048-variant limit applies to every Shopify plan — Basic ($39/mo or $29/mo on annual billing), Grow ($105/$79), Advanced ($399/$299) and Plus (from $2,300 on a 3-year term). No plan upgrade is needed to access the higher limit. Note: Shopify Payments is not available in South Africa; SA merchants typically use PayFast, Peach Payments, or Ozow as their primary gateway.
Before October 2025, the limit was 100 variants per product. A clothing store selling a T-shirt in 6 sizes and 17 colours (6 × 17 = 102 variants) was forced to split into two products or drop a colour. With the new ceiling, that same T-shirt range can now include 6 sizes × 341 colours = 2,046 variants — though a realistic range of 30 colours × 8 sizes × 8 fits = 1,920 variants is more illustrative.
Option-Combination Decision Table
The number of Shopify variants per product you can create depends on how many option dimensions you use. This table shows the maximum option-value counts that stay within the 2,048 limit, with realistic examples for SA product catalogues.
| Options used | Max total variants | Practical split (equal values) | Realistic SA example | Fits 2,048? |
|---|---|---|---|---|
| 1 option | 2,048 | 2,048 values on one option | 2,048 fabric colours on a custom print store | ✓ Yes |
| 2 options | 2,048 | Up to ~45 values × 45 values (45 × 45 = 2,025) | 44 colours × 46 sizes = 2,024 variants | ✓ Yes |
| 3 options | 2,048 | Equal: 12 × 12 × 12 = 1,728; mixed ceiling: 16 × 8 × 16 = 2,048 | 30 colours × 8 sizes × 3 fits = 720 variants | ✓ Yes |
| 4 options (native) | Not supported | — | Colour + Size + Fit + Material requires a workaround | ✗ Workaround needed |
The arithmetic behind the table. With two options of equal depth, the maximum equal split is the square root of 2,048 ≈ 45.25, so 45 × 45 = 2,025 variants. With three options of equal depth, cbrt(2,048) ≈ 12.7, meaning 12 values per option gives 12 × 12 × 12 = 1,728 variants. If you allow unequal option sizes, you can reach the ceiling exactly: 16 × 8 × 16 = 2,048. The key point: for most SA fashion and homeware catalogues, the 3-option ceiling is the binding planning constraint, not the 2,048 total.
Takeaway: The 3-option limit is the real planning constraint
Most SA clothing, sneaker and homeware stores operate comfortably within 2,048 variants per product. The binding constraint is the three-option ceiling. If your product naturally carries four or more dimensions — colour, size, fit, and material, for example — plan for a workaround from the start rather than retrofitting it when the catalogue grows.
Which SA Store Types Hit the Limit Fastest
Product catalogue complexity varies significantly by category. These SA store types most commonly encounter the variant limit or the 3-option ceiling.
Fashion and clothing retailers. A women's clothing store in Johannesburg might carry 30 colour options × 8 sizes × 3 fits = 720 variants — still well within 2,048. Adding a fourth dimension (material: cotton, viscose, linen) would produce 30 × 8 × 3 × 3 = 2,160 variants, exceeding 2,048 and requiring a fourth option that Shopify does not support natively. Clothing is the category where the 3-option limit bites first.
Sneaker and footwear stores. Sneaker retailers typically deal with style, size, and colour. With 6 colourways × 14 sizes × 5 styles = 420 variants per product, the limit is rarely an issue. But limited-edition sneaker drops with 20+ colourways and numerous size options across multiple fits can push towards the ceiling faster than expected.
Custom and personalised gift stores. SA custom gift stores (engraving, printing, embroidery) often need colour + size + personalisation type. The third option (e.g. font style, engraving depth) is usually better handled by line item properties because personalisation text is not stock-managed — you would not hold separate inventory for each font choice. Understanding which options need inventory tracking versus which are fulfilment notes is the first filter for catalogue planning.
Homeware and décor. A SA homeware brand selling cushions might offer pattern × size × fabric = 12 × 4 × 6 = 288 variants — easily within limits. The challenge here tends to be media management: 250 images per product is the ceiling, which can be tight when every colour variant needs multiple product photos.
Workarounds: When 2,048 or 3 Options Is Not Enough
The right Shopify variant limit workaround depends on whether the extra option needs its own SKU, price or inventory count. Four approaches exist; each fits a different set of requirements.
Product splitting — best for: distinct sub-ranges with meaningful inventory separation. Split one large product into two or more Shopify products linked via navigation or metafields. Example: "Running Shoes — Standard Fit" and "Running Shoes — Wide Fit" as separate products sharing a collection page. You get full SKU, pricing and inventory control on each variant. The trade-off is catalogue management overhead.
Shopify Combined Listings app (Plus and enterprise plans only) — best for: displaying product family variants as one storefront unit. This app — available exclusively on Shopify Plus and enterprise commerce plans — groups related products so customers see a single product page with combined selectors, while the underlying products remain separate. Merchants on Basic, Grow or Advanced should use product splitting or line item properties instead.
Line item properties — best for: non-stock-managed options like personalisation text, engraving notes, or custom instructions. Line item properties pass the customer's selection to the cart and order without creating a stock-tracked variant. The key limitation: you cannot assign separate SKUs, prices or inventory levels to line-item-property choices. Do not use them for options that affect fulfilment cost or stock levels.
Third-party product options apps — best for: complex configuration with four or more option dimensions. Apps such as Infinite Options and Hulk Product Options render additional selectors on the product page using line item properties under the hood, giving customers the experience of multiple option dimensions without native Shopify support. As with plain line item properties, pricing and inventory differentiation on these extra options requires custom development or app-specific tooling.
Takeaway: Match the workaround to the requirement
If the extra option affects price or stock, use product splitting or Shopify Combined Listings. If it is a fulfilment note with no inventory implication, line item properties or a product options app is faster to implement. Mixing approaches (native variants for stock-managed options + line item properties for personalisation) is a common and practical pattern for SA custom-product stores.
API and Theme Compatibility
The 2,048-variant limit was made possible by a new Shopify GraphQL product model, released in April 2024. Stores and apps still using the legacy REST Admin API may not handle products with more than 100 variants correctly — not because of a hard block, but because the older API is not designed for the data volume.
If your store relies on a third-party inventory management, ERP or product-feed tool, check that it has been updated to use the GraphQL Admin API before building out your high-variant products.
On the theme side, you need an Online Store 2.0-compatible Shopify theme to render the extended variant selector correctly. Most modern themes (Dawn, Sense, Craft, and their commercial equivalents) are OS 2.0-ready. If your store runs an older legacy theme, the variant picker may truncate at 100 variants or display incorrectly.
One category note: if your SA store is part of Shopify Collective — Shopify's supplier-retailer wholesale network — practitioners report the Collective product feed still caps at 100 variants per product as of mid-2026, even if your primary store has been upgraded. This is worth verifying with Shopify support before structuring wholesale products with high variant counts.
Need to audit your theme or app compatibility before expanding your catalogue?
Share your store details and we will check your setup against the GraphQL product model requirements — no obligation, turnaround within 24 hours.
Book a compatibility auditWhy South African Businesses Choose Growth Pulse Media for Shopify Builds
Growth Pulse Media is a registered Shopify Partner based in Johannesburg, Gauteng. Our founder built and scaled a large South African ecommerce business before starting the agency — which means catalogue architecture decisions, variant structuring, and the trade-offs between native Shopify features and third-party apps are not theoretical for us. They are decisions we have navigated with real SA inventory across clothing, homeware and custom product categories.
We keep a deliberately limited client load so every store gets senior attention. Our Shopify marketing and build work covers store setup, catalogue migration, theme selection and post-launch growth — all executed in-house.
We also integrate with SA payment gateways (PayFast, Peach Payments, Ozow) and local courier services (The Courier Guy, Aramex, Dawn Wing) as part of every build. If your variant structure or catalogue architecture needs a second opinion, we are the right call.
Who This Guide Is NOT For
Merchants whose catalogues have fewer than 100 variants per product. If your store sells simple products — one product with three sizes and four colours (12 variants) — neither limit is relevant to your build. This guide is most useful for high-SKU stores or businesses planning catalogue expansion.
Businesses looking for a quick fix for legacy theme issues. If your current Shopify theme is a heavily customised legacy build, adding high-variant products may require a theme upgrade or developer work beyond what this guide covers. The variant limit is the easy part — theme rendering is where the complexity lives on older stores.
Stores that only sell configurable products via print-on-demand. Print-on-demand products in South Africa (custom T-shirts, mugs, phone cases) typically handle their own variant logic inside the POD app, and the Shopify variant structure may be bypassed entirely. The 2,048 limit is not the relevant constraint for most POD integrations — the POD app's own variant and option logic is.
Shopify Collective wholesale retailers expecting parity with direct-store limits. If you are sourcing products via Shopify Collective, the 2,048 limit does not currently apply to Collective product feeds. Plan your wholesale catalogue separately from your direct-store variant architecture.
Frequently Asked Questions
What is the current Shopify product variant limit?
The Shopify product variants limit is 2,048 variants per product, effective for all merchants since October 15, 2025. This applies across all Shopify plans — Basic, Grow, Advanced, and Plus — with no upgrade required. The previous limit was 100 variants per product. Each product can still have a maximum of three option types (such as Colour, Size, and Material).
Does the variant limit differ by Shopify plan?
No. The 2,048-variant-per-product limit is the same across all Shopify plans, including Basic ($39/month), Grow ($105/month), Advanced ($399/month) and Plus. You do not need to upgrade your plan to access the higher limit. The limit is per product, not per store, so a store can have as many products as needed, each with up to 2,048 variants.
Can I have more than three options per product on Shopify?
Not natively. Shopify limits every product to three option types (for example, Colour, Size, and Fit) — unchanged in the October 2025 update. If you need a fourth option dimension, you will need a third-party product options app, line item properties, or product splitting. Shopify has not announced a timeline for increasing this limit.
What happens if my store exceeds 500,000 total variants?
If your Shopify store's total variant count across all products reaches 500,000 or more, Shopify applies a daily upload limit of 10,000 new variants per day, according to Shopify's official documentation. Shopify Plus merchants are exempt from this restriction. For most SA stores, even large catalogues, this store-wide threshold is unlikely to be reached in normal operation.
Will my existing apps and theme work with products above 100 variants?
Not necessarily. Shopify built the 2,048-variant capability on a new GraphQL product model (released April 2024). Apps that still use the legacy REST Admin API may display or process high-variant products incorrectly, and older themes that are not Online Store 2.0-compatible may truncate variant selectors above 100 variants. Verify both app API versions and theme compatibility before migrating or building out high-variant products.
Ready to build or restructure your Shopify catalogue?
Growth Pulse Media is a registered Shopify Partner in Johannesburg. We handle variant architecture, SA payment gateway integration (PayFast, Peach Payments, Ozow), local courier setup and post-launch growth — all in-house, senior-led. No obligation — we will get back to you within 24 hours.
Talk to a Shopify specialist