Product Variants

Product variants are created by adding multiple products grouped by the same item_group_id field. The item_group_id typically corresponds to the parent SKU, although you can use any other ID to group variants together. All variants for a given product item_group_id must have populated every variant fields (e.g. size, color, gender, and pattern). For custom variants, you can use the additional_variant_attribute field.

Make sure the item_group_id has the same value cross all sizes and colors, and that images and external links match the color of the item.

While the Catalog Manager tool currently does not support an overview of variants, you can use the Facebook shop surface to verify that variants are grouped properly:

Incorrect :

ID Name Color Price item_group_id

CoolShirt123

Cool shirt (parent)

$9.99

CoolShirt123

CoolShirt123_red

Cool Shirt - Red

red

$9.99

CoolShirt123

CoolShirt123_blue

Cool Shirt - Blue

blue

$9.99

CoolShirt123

In the example above, “CoolShirt123” is sent as a parent SKU and the color field is not populated. Since each line item in the field spec needs to be its own product, this is an incorrect way of setting up products.

Correct:

ID Name Color Price item_group_id

CoolShirt123_red

Cool Shirt

red

$9.99

CoolShirt123

CoolShirt123_blue

Cool Shirt

blue

$9.99

CoolShirt123

The above example is the correct way to set up products. Notice that the name of the product and the item_group_id fields match (so that the name does not change when variants are selected, but images do). Both of the above items would roll into one “virtual” parent item.