Marketplace Learn

Notifications

Guides

Getting started

Item setup

Item setup methods

Item content, imagery, and media

Variant management

Product variant groups: Overview

Create a variant group in Seller Center

Create a variant group: Full setup

Manage a variant group

Add multiple items: Virtual packs

Troubleshoot product variant errors

Resold

Automotive fitment

Troubleshooting

Catalog management

Seller Fulfillment Services

Listing optimization

Order management

Taxes & payments

Policies & standards

Growth opportunities

Advertising

Walmart Fulfillment Services (WFS)

Walmart Seller app

Guide

Create a variant group in Seller Center

Last updated on Aug 21, 2025

Reading time: 6 min

In this guide:

Overview
Create a new variant group
Frequently asked questions

Overview

As a Marketplace seller, you can create variant groups in Seller Center or using Walmart APIs. In this guide, you’ll learn how to create a variant group for a group of up to 49 existing items using the Catalog page.

Notes

Too many variations can be confusing for customers. We recommend no more than 50 items for a variant group with a single attribute (a T-shirt in two colors and three sizes) and no more than 500 items for a variant group with multiple attributes (a pair of pants in 25 sizes and 20 colors).

Create a new variant group

Step 1 — Get started

Navigate to the Catalog  page in Seller Center. Next, search for your items by SKU or Item Name using the search bar. Select the check box next to each item you want included in your variant group. Select the More actions dropdown menu, then select Create variant group. Select Create variant group again when the popup window appears.

Notes

If you try to include more than 49 items in your group using the Catalog page, you'll get an error message. Selected Items must be part of the same product type group.

Step 2 — Add the group details

On the next screen, enter the details in each box accordingly: 

Choose a variant group ID: The variant group ID is a unique alphanumeric identifier you'll choose for this group, up to 20 characters long (for example, DryFit_VG5). You’ll use it to track your variant group in the Catalog dashboard once it’s been created.

Select Primary Variant: Select the primary variant to be displayed in search. Primary variants provide suggestions on what item should be highlighted in search for the variant group. The primary variant highlighted for the group and the in search may vary as Walmart determines what item is displayed to the customer. Select the star icon next to the item to make your selection.

Select variant attribute names: Select up to three variant attribute names for the group. These indicate which attributes vary within the group, such as size or color. For example, if an item comes in small, medium and large, the variant attribute name would be size.

Notes

You can’t create multiple variants with identical values. Variant attributes that have the same values, such as size and color, on multiple items will be flagged as an error. Review your items for accuracy and make necessary changes to item details and variants before submitting.

Step 3 — Remove items if needed (optional)

If there’s an item you don’t want to include in the group, select X in the Actions column to remove it.

Notes

There’s no undo function when you remove an item using the Actions column. Make sure you remove the correct item, or you’ll have to start the process from the beginning.

Step 4 – Confirm details and submit

When all fields are complete, select Submit.

Frequently asked questions

How do I add or remove items from an existing variant group?

What if I create a variant group that contains items sold by another seller?

Your groups will merge to appear on the same page on Walmart.com. While you can group, modify and delete your own variant groups, any items in other groups will continue to appear on the item page. Consequently, you may not always be able to define which content will be displayed on a product page if there are multiple sellers providing content for the same item. Walmart will determine the best available content for items unless provided by a brand owner or authorized reseller.

The variant attribute name that I want to use isn’t on the Supported Variant Attribute Names list. What should I do?

You can’t create custom variant attributes. Choosing the correct product type is important because variant attribute names are populated based on the product type of the items in the group.

Check to see if there’s another way you could set up your item using a supported variant attribute name. For example, if you’re selling vitamins in one-, two- and three-bottle packs, you could set them up to vary by count instead of by bottle. If you’re unable to find an alternative like this, you shouldn't set up your items in a variant group.

How does Walmart determine the ranking of variant attributes and how they show up on the item page?

How many different variants can I add to an item?

How can I change the primary variant if it’s out of stock?

If the primary variant goes out of stock, the grouping remains valid, with the primary variant showing as out of stock on the item page. If you decide to discontinue the  primary variant and never add inventory again, you have the option to set a different variant as the primary by updating the variant group list with a different primary item selected. If your item is in a merged variant group and the other seller's primary variant is out of stock, select the Help  button in the Seller Center menu bar to contact Support. 

How can I discontinue the primary variant in a variant group when it matches a variant group set up by Walmart?

The Walmart variant group takes precedence. Your items will be included under Walmart's group if all the items match the items in that group. Matching is done using the item's unique item ID (for example, the UPC or ISBN). If you decide to discontinue the primary variant (by never adding inventory again), you have the option to set a different variant as the primary by updating the variant group ID grouping with a different primary variant selected.

Tell us what you think

Item setup methods: Overview

Item setup

This guide gives a high-level overview to start to build your product listings on Walmart Marketplace.

Go to guide

Add multiple items: Express setup

Item setup

This guide shows you how to add a new item to your catalog by searching products that are currently listed on Walmart.com. If you’re adding a new item to your catalog that’s not currently offered on Walmart, review Add a single item: Full setup.

Go to guide

Add multiple items: Match Walmart’s catalog

Item setup

In this guide, you’ll learn how to add multiple items to your catalog in Seller Center by matching them to products that are currently listed on Walmart.com.

Go to guide

About Walmart.com

Walmart Inc. (NYSE:WMT) helps people around the world save money and live better- anytime and anywhere - in retail stores, online, and through their mobile devices. Each week, approximately 240 million customers and members visit more than 10,500 stores and numerous eCommerce websites in 20 countries. With fiscal year 2023 revenue of $611 billion, Walmart employs approximately 2.1 million associates worldwide. Walmart continues to be a leader in sustainability, corporate philanthropy and employment opportunity.

Seller Resources

Developer Portal

Seller Center

Seller Support

Get to know us!

Shop Walmart.com

Corporate

@WalmartLabs

The Walmart Digital Museum