Guides·
Why native Shopify variants win in agentic AI shopping
Native Shopify variants beat fragmented products in agentic AI shopping. Why ChatGPT, Google AI Mode, Copilot, and Perplexity reward consolidation.
Shopify's variant, option, image and rate limits, and how Merges works within them.
Using Merges effectively means understanding the constraints set by Shopify's platform. Merges respects every one of these limits - this page explains what they are, what they mean for your merges, and how Merges works within them.
Shopify allows up to 2,048 variants per product. Merges will not produce a product that exceeds this cap. If the products you select would generate more than 2,048 combinations, Merges flags the conflict in the preview and prompts you to reduce scope.
Shopify permits a maximum of 3 options per product (for example: Color, Size, Material). Merges works within this cap by combining options intelligently - see the section below.
Shopify allows up to 250 images per product, and this limit is strictly enforced at the API level. Merges deduplicates pixel-identical images automatically. If the deduplicated image set still exceeds 250, Merges surfaces a warning in the preview before saving so you can trim the selection.
Stores with 50,000 or more variants are subject to a Shopify rate limit of 1,000 new variants per 24 hours. Merges respects this limit. For very large stores, a single large merge session may need to be split across two days to avoid failing writes. Smaller stores are not affected.
Variants are the product of option values. A product with Color (3 values) and Size (5 values) has 3 × 5 = 15 variants. Before merging, it helps to estimate the resulting count:
Model option (2 values) → 3 × 5 × 2 = 30 variants.Model (4 values) → 4 × 6 × 4 = 96 variants.When the products you select collectively have more than 3 options, Merges combines options to fit within Shopify's 3-option cap.
Example:
Merges produces a merged option structure like:
Combined options: Color / Size, Season, Material
This approach keeps the variant space intact while respecting the 3-option limit.
Merges supports merging products that together have up to 6 distinct options, condensing them into Shopify's 3-option layout. This is particularly useful for large, diverse catalogs that need to consolidate without losing variant detail.
Shopify's product.variants Liquid object caps at 250 variants unless the theme implements Shopify's high-variant APIs (introduced alongside the 2,048-variant limit). Themes built before this update typically do not. If your merged product has more than 250 variants, it will likely render only the first 250 on the storefront unless your theme has been updated.
Even under the 250 cap, some themes degrade in performance at 100+ variants. After saving a merge with a high variant count, test on your storefront:
If rendering is broken or slow, consult your theme developer. This is a theme-layer issue, not a Merges limitation.
If you hit a limit and are not sure how to work around it, email support@merges.io with the products you are trying to merge and we will help you scope the merge.