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.
Handling duplicate variant option values
Merges for Shopify allows you to combine multiple products into a single listing efficiently. However, due to Shopify's requirement that option value combinations must always be unique, there are specific steps you need to follow to manage option values correctly during the merging process.
Shopify requires every option value combination on a product to be unique. When you merge products that share option values, the resulting combinations can collide (for example, two source products both offering Size: M). Merges handles this automatically, but the outcome needs review before saving.
How Shopify enforces uniqueness
Every variant on a Shopify product is defined by its option value combination. If two variants resolve to the same combination - for example, Color: Black / Size: M - Shopify rejects the product.
Single-option example. Two source products both offer sizes S, M, L, XL. Merged naively, the result would have two variants for each size. Collision.
Two-option example. Two source products both offer Color (Red, Blue) and Size (S, M). Merged naively, the result would have two variants for each Color / Size pair. Collision.
How Merges resolves collisions
When Merges detects that collapsing the source products into a single option structure would produce duplicate combinations, it inserts an additional option called Variant with values Variant 1, Variant 2, and so on. The extra option makes every combination unique.
The Variant option is only added when collisions would otherwise occur. If the source products' option values are already unique across the set, no extra option is added.
Cleaning up the Variant option
You have two ways to handle the added Variant option before saving.
Option 1. Rename the Variant option in place
If the Variant option represents something meaningful in your catalog (a pattern, a model year, a finish), rename it:
- In the Merges editor, locate the
Variantoption. - Change the option name from
Variantto something descriptive (Pattern,Model,Finish). - Rename the individual values (
Variant 1,Variant 2) to match.
Change the Variant option name
Changing the option name
Rename values within the Variant option
Renaming option values
Option 2. Make the existing values unique and delete the Variant option
If the added option does not map to a real differentiator in your catalog, the cleaner path is to remove it:
- Identify which source products contributed the overlapping values.
- Rename the overlapping values so every combination is unique (for example,
S/S 2,M/M 2). - Delete the
Variantoption once every combination is unique.
Identify products that share duplicate option values
Identifying the overlap
Rename duplicate option values to make them unique
Renaming the values
Delete the Variant option after values are unique
Deleting the extra option
Need help
For help resolving a specific collision, email support@merges.io with the source product URLs and a description of the option structure you want.