Skip to main content

Variant requirements

Use the following columns to define variant products.

note

The value for variant-group-id must be unique. You cannot reuse a variant-group-id even if the product that formerly used that ID is no longer available.

Both variant-group-id and variant-group-info are required.

If you use a retailer_reference_code in conjunction with a group of lookup_codes, the variant-group-id must be the same for all lookup_codes. For more information, see Minimum catalog requirements.

ColumnRequiredData typeDescriptionExample
variant-group-idYesstringThe unique identifier for the product variant family.

An empty value for this item indicates the product is not a variant product. When variant-group-id is empty, any other information about this product found in variant-group-info is ignored. However, if after an update variant-group-id is empty, the product continues to be included in the originally specified variant group.

To remove a product from a variant group, use 0.
6350873
variant-group-infoYesJSONDimension descriptor. Dimension names are not displayed and can be any string. Descriptive names are preferred. The order in which you include the dimensions in the inventory file is the order they are displayed on the storefront. For more information, see Variant dimensions. For multiple language storefronts, see Locale-specific variant dimensions.None available.

Before you send your files, consider using a JSON validator.