You can set up your items for sale on Walmart.com with the Item Management API. Walmart classifies a product with its corresponding listing price information as an “item.” To make your items available for customers to purchase on Walmart.com the items must have their prices adjusted (optional), have inventory assigned, submitted and published.
Note: You need to complete seller registration, and get your API Key (Client Secret and Client ID) to start item integration. To access your API Key, go to My Account. Select Login Type, choose Marketplace to get to API Keys. |
To learn more about item setup strategies and concepts, see SellerHelp Walmart. To learn how to set up items in bulk, see Add Items in Bulk. To learn about how to group items, see Variant Setup.
Submit and publish processes
As a seller, you trigger the submit and publish processes in a single action. To add or change inventory requires a separate action.
Item submit process will parse and classify an item. This process typically takes a few hours. Item publish process requires Walmart systems to process items that have all necessary attributes confirmed. This typically takes a few hours.
Note: We recommend that you set up a process to monitor and ensure that your items get pushed to Walmart.com. |
About item spec versions
The Marketplace APIs provide two item spec versions: item spec v3.2 and v4.2. The legacy version v3.2 does not provide the enhanced setup workflow, and other improvements. We recommend that you use the new optimized Item spec v4.2 to take advantage of improvements.
To learn more about item setup strategies and concepts, see SellerHelp Walmart. To learn how to set up items in bulk, see Add Items in Bulk. To learn about how to group items, see Variant Setup.
Setup Item Variants with APIs

The Get item count by groups API allows you quickly view the item variant group IDs and counts of variant groups. With the data from this API, you can use it to filter Get All Items API, Get and item API, and Catalog Search API.
- – Catalog Search: Add the additional query below to search for the variant Group ID with the Catalog Search API.
"query": {
"field": "variantGroupId",
"value": "string"
}
Optimized Item setup and maintenance with Item Spec 4
Item spec v4 optimizes the Walmart Global Data Model with new and improved existing attributes, and a faster, more efficient item setup and maintenance process. Improvements include:
- Better data definitions, modern attribute names, and precise attribute organization.
- Increased buyer search discoverability for your items.
- Increased variant grouping options that organize products in site navigation for better buyer visibility.
- New product and compliance attributes.
- Single setup process with one spec for combined Marketplace and WFS items.
- Automated product tax code assignment.
- Ability to set Sales restrictions for WFS-eligible items by state or zip code due to reasons: Commercial, or Illegal for sale.
To take advantage of the new item management efficiency, make sure to use the Item 4.2 spec and new feed types when you do your initial setup with the Bulk item setup API.
About item spec versions
The Marketplace APIs provide two item spec versions: item spec v3.2 and v4.2. The legacy version v3.2 does not provide the enhanced setup workflow, and other improvements. We recommend that you use the new optimized Item spec v4.2 to take advantage of improvements.
To take advantage of the new item management efficiency, make sure to use the Item 4.2 spec and new feed types when you do your initial setup with the Bulk item setup API.