Set up the Walmart Marketplace Product Creation export
Create and update product listings on Walmart Marketplace (US) directly from Productsup, including category-specific attributes, variants, and swatch images.
The Walmart Marketplace Product Creation export lets you create new product listings on Walmart Marketplace and update existing ones directly from Productsup. It connects via the Walmart Marketplace REST API and currently supports the US marketplace.
Prerequisites
Before setting up the Walmart Marketplace Product Creation export, confirm the following:
- You have an approved Walmart Marketplace seller account (US) with access to Seller Center.
- You are ready to authorize Productsup to access your Walmart account. You do this as part of Configure the destination below.
Add the export
Go to Exports from your site's main menu and select ADD EXPORT.
Search for Walmart Marketplace - US - Product Creation and select Add.
Select the export's name link.
Configure the destination
Select Add Destination and choose Walmart Marketplace Products from the dropdown. Give it a name as desired and select Save.
In Authentication, choose an existing authentication or select Add New Authentication.
Selecting Add New Authentication redirects you to Walmart's authorization page. After you approve access, Walmart redirects you back to Productsup automatically.
Toggle Active to On to activate the destination.
Select Save.
Set up category mapping
Walmart has more than 6,700 product types, each with its own required and optional category-specific attributes. Map your product categories to Walmart's categories using a Classification Mapping list so Productsup knows which attributes to make available to you.
Not every Walmart category is available in Productsup today. If a category you need doesn't appear when you set up the Classification Mapping list below, contact support@productsup.com to request it.
Caution
Automotive product types that require fitment data (vehicle compatibility submitted as ACES/PIES files) aren't supported. If you sell automotive parts that require fitment, contact your Customer Success Manager before setting up this export.
Go to Lists from your site's main menu and select ADD LIST.
Choose Classification Mapping and select Continue.
In Name, give your list a desired name.
In Classification, choose Walmart Marketplace - US - Product Creation.
In Stage, select Import to replace your imported categories with the categories accepted by Walmart.
In Attribute, choose your category attribute from your imported attributes.
Select Add.
Map your categories, pre-populated in the right-hand column, to the corresponding Walmart product categories in the Replace term column.
Create a new Classification Mapping list every time you change the category attribute in your data source or import new category values into your site.
Map attributes in Dataflow
Go to Dataflow from your site's main menu and select Walmart Marketplace - US - Product Creation in the dropdown on the left.
Map your category attribute in the import stage to __category_path in the intermediate stage.
Select __category_path in the intermediate stage to add the Classification Mapping rule box. Choose the list you created in Set up category mapping from the List dropdown, and configure Case Sensitivity and On No Match as needed. Select Save.
Select Run or Import in the top-right corner to load your categories and attributes into Dataflow.
This first run is expected to fail — no data is exported yet. Its only purpose is to load the Walmart categories and their attributes into Dataflow.
Once the run completes, open the Classifications dropdown in the top toolbar of Dataflow. It now lists all your mapped Walmart product categories. Refresh the page if the dropdown doesn't appear.
Select each category in the Classifications dropdown and map its relevant attributes from import to export. Attributes with a fork icon next to their name are specific to the selected category.
Set up variants
If your products have variants, for example different sizes, colors, or counts of the same product, set up each variant as a separate row. All variants in a group share the same variantGroupId.
Map the following attributes:
| Attribute | Description |
|---|---|
variantGroupId | The same value for every item in the variant group. |
isPrimaryVariant | Set to Yes for exactly one item in the group — typically the top-selling item or the one with the most inventory. This is the item Walmart displays by default. |
variantAttributeNames | Up to three attributes that vary within the group, for example size, color, or countPerPack. Each attribute you list here must also be mapped and visible at the export stage, or the submission fails. |
For example, a curtain set available in 2 sizes and 6 colors needs 12 rows, all sharing the same variantGroupId.
Set up swatch images
For visual variants such as color, you can provide swatch images that Walmart displays on the item page. Map the following attributes:
| Attribute | Description |
|---|---|
swatchVariantAttribute | The attribute the swatch represents, for example color. |
swatchImageUrl | The URL of the swatch image for each variant. Walmart recommends a resolution of 100 x 100 pixels at 72 ppi. |
Tip
Include swatch image URLs on every row when you resubmit variants. Leaving them out can remove existing swatch images from the live listing.
Common pitfalls
| Pitfall | What to do |
|---|---|
| The first export run fails | This is expected. The first run only loads Walmart's categories and attributes into Dataflow. Map the remaining mandatory attributes and run again. |
| The Classifications dropdown doesn't show your categories | Refresh the page after the first run. If categories still don't appear, check that your category attribute is correctly mapped to __category_path. |
| A category you need isn't in the Classification Mapping list | Contact support@productsup.com to request it. |
| Variant submissions are rejected | Confirm that every attribute listed in variantAttributeNames is also mapped and visible at the export stage. |
How is this guide?