Product Variants

Product variants are created by adding multiple products grouped by the same item_group_id field. This field 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 field (for example, 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 — “CoolShirt123” is sent as a parent SKU and the color field is not populated. Because each line item in the field spec needs to be its own product, this is an incorrect way of setting up products.

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

Correct — This example shows the correct way to set up products. 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 items below would roll into one “virtual” parent item.

ID Name Color Price item_group_id

CoolShirt123_red

Cool Shirt

red

$9.99

CoolShirt123

CoolShirt123_blue

Cool Shirt

blue

$9.99

CoolShirt123

For details about the fields, see Reference.

Product Group Variants Example

You can specify variants for a product in the form of a product group. An example of variants is a tee-shirt with 3 sizes (S, M, L) and 4 colors (Red, Yellow, Blue, Green). In this case, we can create a product group (with retailer id as tee-shirt and 12 individual products consisting of the variant options (S+Red, M+Red, L+Red, S+Yellow, M+Yellow, L+Yellow, S+Blue, M+Blue, L+Blue, S+Green, M+Green, L+Green).

Include these columns for the product_group in the product feed. The other required columns are excluded from this example for simplicity sake, but you need to specify them in the actual feed file.

ID item_group_id Variant

tee-shirt-S-Red

tee-shirt

size:S/M/L:S,color:Red, Yellow,Blue,Green:Red

tee-shirt-M-Red

tee-shirt

size:S/M/L:M,color:Red, Yellow,Blue,Green:Red

tee-shirt-L-Red

tee-shirt

size:S/M/L:L,color:Red, Yellow,Blue,Green:Red

tee-shirt-S-Red

tee-shirt

size:S/M/L:S,color:Red, Yellow,Blue,Green:Yellow

tee-shirt-M-Yellow

tee-shirt

size:S/M/L:M,color:Red, Yellow,Blue,Green:Yellow

tee-shirt-L-Yellow

tee-shirt

size:S/M/L:L,color:Red, Yellow,Blue,Green:Yellow

tee-shirt-S-Blue

tee-shirt

size:S/M/L:S,color:Red, Yellow,Blue,Green:Blue

tee-shirt-M-Blue

tee-shirt

size:S/M/L:M,color:Red, Yellow,Blue,Green:Blue

tee-shirt-L-Blue

tee-shirt

size:S/M/L:L,color:Red, Yellow,Blue,Green:Blue

tee-shirt-S-Green

tee-shirt

size:S/M/L:S,color:Red, Yellow,Blue,Green:Green

tee-shirt-M-Green

tee-shirt

size:S/M/L:M,color:Red, Yellow,Blue,Green:Green

tee-shirt-L-Green

tee-shirt

size:S/M/L:L,color:Red, Yellow,Blue,Green:Green