Variant groups and re-parenting: grouping supplier items and changing a live group

On Walmart.com a variant group is one item page with option selectors — color, size, count — where each option is a separate item with its own Walmart item number, GTINs and content. There is no parent record: the group is a relationship between real items, not a non-buyable parent as on Amazon.

For a supplier the group lets a shopper switch options on one page and, in most categories, share ratings across them. It does not decide what Walmart carries: the merchant approves each item on its own and decides its stores, and an option not approved for online sale shows as unavailable or not at all.

Who may change a live group follows the same split between the supplier's data and the merchant's decisions. Supplier One's Catalog — your item list, with a variant details view per group — shows each group's structure but lets you edit it only in some cases; Changing a live group covers which.

New groups are usually built in the Setup Hub by bulk spreadsheet (Item setup covers both routes), since one file keeps every row's ID and attribute names identical. Columns vary by spec version; typically:

• Variant Group ID — a string you define, identical on every row: the shared key.
• Variant attribute names — the attributes that differ, from the product type's allowed list (check the current cap), identical on every row.
• Values — each row's value per attribute, consistent in spelling, casing and units; no two rows may share a combination, since Walmart rejects a duplicate at submission.
• Primary variant — a flag on exactly one row: the item the page opens on.
• Images and swatches — each row's own images and, where the product type supports them, swatches for the named attribute.

Submit the rows together. The Submissions Manager (older guides called it the Activity Manager or Activity Monitor) tracks each item; the merchant approves each separately, and the live group shows only approved, published items.

You submit — your own items' values, images and swatches through the Maintenance Hub, editable group or not (item fields, not structure); and a new item joining via the Setup Hub:

1. Confirm the group's attribute names and values in the Catalog or live selector.
2. Submit the item with the Group ID and values matching in spelling, casing and units.
3. Check the Submissions Manager for its status and reason.
4. Check the option selector once it is live.
5. Log the result against the item number.

You edit in the Catalog, when every item is yours — its variant tools (labels like Manage Variant and Edit Variant Details) group, merge, split and change the primary in current accounts. Not by maintenance file as of this writing — a bulk variant edit is planned; check the current help article.

The merchant — a read-only group (another supplier's items), re-grouping live items in most accounts, and an item that fell out after clean resubmission. Send item numbers, GTINs, the intended grouping, values and primary: a request, not a support ticket.

The live page is the only proof. Once every item is approved and published, open the group as a shopper and check:

• Every option is visible and named as intended; a missing option is a group fault — a mismatched name, a rejected duplicate, or an unpublished item.
• Selecting an option switches the page — image, name and availability become that item's own.
• No near-duplicate values — Walmart rejects a true duplicate at submission, so two look-alike options are usually a near-duplicate (Navy and Navy Blue, a casing or unit difference); make the values distinct, or add a second attribute so each combination is unique.
• The primary makes sense — the default item is published, available and representative.
• Out-of-stock options behave — in most categories an option with no stock stays visible but unavailable; one that disappears entirely is a group or publishing fault, not a stock event.

A group passes only when every option does.

Five causes cover most broken groups:

• Items in different product types — each type has its own allowed list, so the group cannot form; fix the type before submitting, in the Catalog if editable to you, or through the merchant.
• Mismatched attribute names — one item declares color, another color and size; the odd item lands outside the group.
• Duplicate values — two items carry the same values; Walmart rejects the later one, so change one value or add a second attribute (Blue/Small, Blue/Medium) and resubmit.
• An unpublished or unapproved primary — the page opens on an item you did not choose; a field rejection is yours, a merchant-review hold the merchant's; meanwhile make an approved, published item primary, in the Catalog or through the merchant.
• DSD (direct store delivery) and owned items mixed — different logistics and setup paths; the group may not form, so ask the merchant first.

If clean data still will not group and the merchant asks for a ticket, Supplier support tickets covers it.