Walmart Setup By Match

What is Setup by Match?

Setup by Match is a Walmart Marketplace listing method that lets you quickly list products that already exist in Walmart's catalog. Instead of providing a full set of product attributes (descriptions, category-specific fields, specifications, etc.), you only need to supply a few required fields. Walmart matches your item to an existing catalog listing using a product identifier like a UPC or GTIN, and automatically fills in the rest of the listing data.

This method is ideal for sellers listing items that other sellers already offer on Walmart.com. If Walmart cannot find a match for your identifier, you'll need to use the standard Full Item Setup flow instead.

For more details, see Walmart's Quickstart Guide to Setup by Match.

SureDone Settings

Setup by Match is controlled by two settings: an instance-level default and a product-level override. These settings only apply when listing a product on Walmart for the first time - updates to existing listings are not affected.

Instance-Level Default

This toggle controls whether Setup by Match is used by default for all new Walmart listings on a given instance.

• Location: Settings → Channel Settings → Walmart → Instance Settings
• Setting: "Default Use Item Match (MP-ITEM Match Spec)"
• Options: on / off (default: off)

When enabled, all new products will use Setup by Match unless overridden at the product level.

Product-Level Override

This dropdown on each product lets you override the instance default.

• Location: Product Editor → Walmart tab → "Use Item Match" dropdown
• Options:
  • default - Follow the instance setting (this is the default)
  • on - Use Setup by Match for this product
  • off - Use standard full item setup for this product

Required and Optional Fields

Required Fields

• SKU - Your SureDone GUID. Sent automatically.
• Product ID + Type - A valid UPC, GTIN, EAN, or ISBN that matches an existing Walmart catalog item.
• Price = Selling price.
• Shipping Weight - Weight in pounds.
• Condition - Item condition. Defaults to New if not provided. Accepted values: New, Pre-Owned: Like New, Pre-Owned: Good, Pre-Owned: Fair, Remanufactured, New with defects, Open Box, New without box, New without tags

Optional Fields

• Main Image URL - URL to the product's primary image.
• Additional Image URLs - Additional image URLs (pipe-separated or comma-separated).
• Product Category -  A broad Walmart category (e.g., "Clothing", "Toys") that can improve match accuracy. This is not the same as Product Type used in full item setup.
• External Product ID (ASIN) - An Amazon ASIN as an additional identifier.
• State Restrictions - Sale restrictions by state or zip code. Multiple entries separated by *.
• Additional Product Attributes - JSON key-value pairs for extra product attributes (e.g., {"color": "Red"}).
• Additional Offer Attributes - JSON key-value pairs for extra offer attributes.

Using Setup by Match in the UI

1. Go to Settings → Channel Settings → Walmart and enable Default Use Item Match if you want it on by default, or leave it off to enable per product.
2. Open a product in the editor and go to the Walmart tab.
3. Ensure your product has a valid product identifier (UPC/GTIN/EAN/ISBN), price, and shipping weight.
4. Set the Use Item Match dropdown to on (or leave it on default if the instance default is already enabled).
5. Save and list the product to Walmart.

A tooltip on the Use Item Match field summarizes the required and optional fields for quick reference.

Using Setup by Match via Bulk Uploads

Include the useitemmatch column in your bulk upload file to control Setup by Match per product.

Bulk Field Headers

• Walmart instance 1: walmartuseitemmatch
• Walmart instance 2: walmart2useitemmatch
• Walmart instance 3: walmart3useitemmatch

Accepted Values

• default — Follow the instance-level setting.
• on — Use Setup by Match for this product.
• off — Use standard full item setup for this product.

Example

Important Notes

• This field only affects new listings. Updates to existing Walmart listings are not affected.
• If Walmart cannot match your product identifier, it will return a feed error. You'll need to relist using the standard full item setup (off) with all required product type fields.

FAQ

What happens if Walmart can't match my product? Walmart will return a feed error. You'll need to list the product using standard full item setup instead.

Does Setup by Match work with variations? Yes, but each variant (and the parent) must be listed individually with Setup by Match enabled.

Can I switch methods after listing? No. The Use Item Match setting only applies at initial listing time. To change methods, you'd need to remove the product from Walmart and relist it.