Articles on: Frequently Asked Questions (FAQ)

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.


Available on: ✔️ Add



How to Merge New Variants into Existing Products


Go to App → Feed Settings → Step 2: Matching Column


  1. Enable the merge option in Product Identifier: In the Add feed, turn on Merge in the Product Identifier field.
  2. Open Variant Group Smart Settings: Click Smart Settings under Variant Group.
  3. 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.



Each new variant added this way uses one credit.



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


Updated on: 13/11/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!