Setting up multiple variants of an item

Sellers can set up multiple variants of a single item using the variant parameters in the POST Bulk Item Setup and Maintenance by Product Type call. The variant group attributes defined in the POST Bulk Item Setup and Maintenance calls can be utilized to create new variant groups or update existing groups.

Each item in a variant group should be set up as a separate item. For example, a curtain set that comes in two sizes and six colors should have a total of 12 individual items (MPItems), and they can all be included in the same submission. Each item should include the same variant group ID and also include the relevant variant group information (for example, the attribute on which the variant is based).

Variant group attributes include:

• variantGroupId: Identifies all the items in a variant group. Different variant groups should have different variant group IDs.
• isPrimaryVariant: Defines the default item on the Walmart.com item page. This is usually the top-selling item or the item with the most inventory. Only one item in a variant group should be selected as the primary item.
• variantAttributeNames: Indicates which attributes vary within the group. Variant groups can vary by up to three attributes, such as size, color, and count per pack.
  NOTE: Make sure that the selected variant attribute is also present in the Visibleattribute section. Submissions of variantAttributeNames which do not have the attribute present in the visible section will fail.

Example

{ "MPItemFeedHeader": { "businessUnit": "WALMART_US", "locale": "en", "version": "2.0.20230221-12_22_32-api" }, "MPItem": [ {"Orderable": { "productId": "123456", "sku": "ABC123"}, "Visible": { "Toothpastes": { "productName": "Colgate Crest Toothpaste", "flavor": "Peppermint", "variantGroupId": "001960968586AX6", "isPrimaryVariant": "Yes", "variantAttributeNames": "flavor"}}}, {"Orderable": { "productId": "123456", "sku": "ABC1245"}, "Visible": { "Toothpastes": { "productName": "Colgate Crest Toothpaste", "flavor": "Spearmint", "variantGroupId": "001960968586AX6", "isPrimaryVariant": "No", "variantAttributeNames": "flavor"}}}]}