How to merge new variants with existing products?
You can merge new variants into products that already exist in your store, so a product gets its new sizes or colors without creating a duplicate listing. This is set up with the Variant Group field in an Add feed.
How to Merge New Variants into Existing Products
Go to App → Feed Settings → Step 2: Matching Column
- Enable the merge option in Product Identifier: In the Add feed, turn on Merge in the Product Identifier field.
- Open Variant Group Smart Settings: Click Smart Settings under Variant Group.
- Turn on Merge variants: Turn on the toggle. Variants are then merged with existing products, and you must select the same group for the merge.

Requirements for a Successful Merge
- Add feed only: The Variant Group option is available only in Add feeds. Update feeds can change quantity, price, and other fields, but they cannot create new variants.
- Matching identifier: The feed needs a Product Identifier (such as SKU, handle, or barcode) that matches the existing product in your store.
- Shared group value: All variants of the same product must have the same Variant Group value.
- Unique identifiers for new variants: A new variant's identifier must not already exist in Shopify. If it does, the variant cannot be created and the merge fails.
Merge Scenarios
1. Match by Product Title
If your feed contains the same product titles as your store, you can use them to merge variants. Make sure each variant has a unique SKU as its identifier.

2. Match by Barcode
If your feed has the same barcode as your store, you can use it to merge variants. Make sure each variant has a unique SKU as its identifier.

3. Same SKU in Feed and Store
If your feed has the same SKU as your store, the variants cannot be merged.

4. Wrong Variant Group Option
Select the correct option in the Variant Group Smart Setting. Otherwise, the variants will not be merged.

Tag Merged Variants
When new variants are merged, you can add a tag to see which variants were merged. Use this to check the merged items in your store.

Key Rules & Technical Details
- Unique SKUs: If all variants in Shopify share the same SKU, every incoming row is treated as already existing, and the merge count stays at 0.
- Shared fields: If all rows share the same SKU or barcode, the merge fails unless another unique field, such as handle or parent ID, identifies each variant.
Troubleshooting Steps
- Issue: The merge count stays at 0 → Solution: Check that each variant has a unique SKU or another unique field mapped as the Product Identifier.
- Issue: Variants are not merging into the existing product → Solution: Check that the Variant Group value is shared by all variants and matches the existing product's group.
- Issue: The new variant fails to merge → Solution: Check that its identifier is not already used by a variant in your store.
Good Articles to Continue
- Variant Group & Variant Option Field (Product Options) → Learn how to group variants and map variant options such as size and color.
- How to Add New Variants to Existing Products in Shopify Using Stock Sync → Step-by-step guide to adding new variants to products already in your store.
- How do I import items with a CSV file in Stock Sync and handle new variants? → Import CSV variants and merge them into existing products.
Updated on: 13/11/2026
Thank you!
