Guides·
Native variants vs. combined listings: what Shopify actually sees
Combined listings apps change what shoppers see. Native variants change what Shopify sees. Compare how each approach affects POS, ERPs, feeds and SEO.
Why sizes show as unavailable and swatch images disappear on merged products with more than 250 variants, and how to fix it in your theme.
Shopify allows up to 2,048 variants per product, and Merges creates merged products up to that limit. Many themes, however, still only read the first 250 variants of a product. If a merged product with more than 250 variants shows some sizes or colours as unavailable in your store, this page explains why and how to fix it.
Your theme builds the variant picker from the product data Shopify hands to it, and that data contains at most the first 250 variants. Every variant after that exists in your admin, has stock, and can be ordered through the API, but the theme never sees it. So the theme treats those combinations as unavailable.
Which variants get cut off follows from the option order. Shopify lists variants by the first option, then the second. With Size first and Colour second, the list runs through every colour of the first size, then every colour of the second size, and so on. The first 250 entries cover the smaller sizes in all colours, and the sizes at the end of the list are missing in every colour. That is why the same sizes look sold out everywhere.
The product data itself is fine. Open the merged product in your Shopify admin and every variant is there with the correct inventory. Nothing needs to be changed on the product, and nothing needs to be changed in Merges.
The admin notice appears on every product with more than 250 variants, whether or not your theme supports them. It is a reminder to check, not a diagnosis.
The fix is a theme update. Merges adds no code to your storefront and cannot change how the theme reads variants (see Is Merges slowing down my store?).
Products with several hundred variants are heavier for the browser even in a compatible theme. After the update, also check on a phone that switching options, image changes, and add to cart still respond quickly.
A customised theme does not receive updates from the theme developer, and some older paid themes are no longer maintained. In that case the variant picker in your theme has to be updated by a developer. Send them this link: Support high-variant products. It is Shopify’s own guide for exactly this change.
If updating the theme is not an option right now, keep merged products under 250 variants. Merge in smaller groups instead, for example by size range or colour family, so each merged product stays below the limit. See Advanced usage and limitations for how to estimate the variant count of a merge.
Option values that never existed for a given colour show as unavailable by design. If a t-shirt is stocked in 8 sizes in Black but only in S, M, and L in Sand, the other 5 sizes are correctly greyed out when Sand is selected. That is standard Shopify behaviour, not a theme issue.
For other storefront display questions, see Troubleshooting common issues.
