How to Add Products with Variants to Your Store

When adding products that contain multiple variants (such as size, color, length, or width), ensure that both your product structure and feed settings are aligned. Below are the key requirements and steps to successfully add products with variants using Stock Sync.

1. Ensure Variants Belong to the Same Product

Stock Sync groups variants based on the merge rule you select. To make sure variants are correctly added under one product:

• Use one shared product title for all variants, or
• Use a shared identifier such as group_id, SKU, barcode, or Variant Group depending on your feed structure.

Variant titles must match the merge rule exactly. For example, if you merge by product title, all variants must have the same title. Additional details (size, length, color) should be placed in Variant Option fields, not in the main product title.

Important: Every variant row must include the product title or another required parent-product value used for grouping. If the source feed includes the title only on the first row and leaves it blank on subsequent variant rows, those rows may not be imported. Ask the supplier to fill the parent product title down into every corresponding variant row, or preprocess the feed to do so. A pre-parsing rule or script can also fill down the parent title before the feed is processed.

2. Use Variant Group and Variant Option Fields

To add variant sets correctly:

• Populate the Variant Group field in your feed, which can be found under the Variant Group setting.
• Map variant attributes such as Color, Size, Width, or Length to the corresponding Variant Option fields.
• Ensure the variant and option fields are mapped; mapping only title and description is not sufficient to create variants.
• If the feed has a hierarchical layout, ensure the parent product metadata is present on every variant row; otherwise, the parser cannot assign those rows to a product group.

3. Adding Variants to Existing Products

If a parent product already exists in your store, Stock Sync will skip duplicates unless the merge rule matches. To add missing variants to existing products:

• Ensure the variant identifiers exactly match the fields used in your merge setup.
• Confirm the variant titles or group identifiers are consistent with the existing product.
• If the existing product was created without variant options, new variants may not merge into it; re-import the product with complete variant data.
• Use an Add feed for new variants; an Update feed cannot create new variant options.

4. Preview Before Adding

Always use Preview Sync before importing. The preview will show:

• Number of products to be added
• Whether variants are grouped correctly
• Any skipped or mismatched items

If everything looks correct, proceed with the real sync.

5. Variant Limits May Affect Adding Products

Your store’s variant limit may prevent adding new products or variants. If you reach the limit:

• Reduce existing variants or products, or
• Upgrade your Shopify plan if applicable.

6. If Variants Display Incorrectly

If variant titles, colors, or sizes become mixed up:

• Recheck your mapping for Variant Option fields
• Ensure each Option has the correct name and source column
• Undo or reverse the feed if needed before re-syncing

Summary

To successfully add products with variants:

• Use consistent identifiers for grouping
• Map Variant Group and Variant Option fields correctly
• Ensure titles match if using title-based merge
• Ensure parent product values are present on every variant row
• Preview before adding
• Check your store’s variant limit

Following these steps ensures your products and variants are added cleanly and grouped correctly in your store.

Updated on: 31/07/2026