Header Image
Guide
Troubleshoot item setup errors
Last updated on Dec 19, 2024
Reading time: 5 min
Overview

Our system automatically scans every Walmart template for errors. It checks for missing required attributes, incorrect data types, invalid check digits, copy-paste errors and more. This guide shows you how to find and address errors if your template fails the pre- or post-validation check.

Common upload errors 

1. Invalid product ID 

The error message could identify invalid Product ID for the selected Product Identifier and will tell you which row has the error. 

What should I do?

Correct the error in the file then save the file and upload it back in Seller Center.  Check out Troubleshoot Product ID Errors to learn more. 

2. Missing attribute metadata 

The error message could identify missing attribute metadata. 

What should I do?

You should download a new spreadsheet if you are not sure what was deleted/altered. Make sure not to delete any data in Row 1-6. If you added multi-select attributes, make sure that all the information in rows 4-6 were copied and pasted into the new columns. Check out this guide to learn more about multi-select attributes.  

3. Error file  

If you encounter an error while uploading an item setup spreadsheet, an Upload error message will automatically download the file. In this error report, you can easily identify the number of errors and their descriptions in columns A and B. All cells that contain errors which need to be fixed will be highlighted.

What should I do?

Correct the errors in the highlighted cells, then re-upload the template when finished. Once your upload completes, navigate to the Activity Feed dashboard to confirm the template processed successfully. Review this guide if the error relates to an invalid product ID.  

Pro tip

Before uploading your template, double-check that you’ve filled out all of the required attributes, that they are within the character limit and that attributes with closed-list options have been properly selected. 

Common post-upload errors

1. Main Image URL does not meet our image URL requirements 

What should I do?

Review this guide to view our image URL requirements and update your content accordingly. You can make updates within the report or within the Full Item Setup template. Then, re-upload the document into Seller Center and check the Activity Feed to make sure your errors are resolved.

2. You are not authorized to set up ‘CUSTOM’ Product IDs for UPC exemptions 

What should I do?

Find the correct product ID for your item. If you sell products that don’t have a product ID (e.g., private label or handmade jewelry), you can request a UPC or GTIN exemption to sell these items on Walmart.com. To request an exemption, select the Help button in the Seller Center menu bar to contact Support. 

If the item you want to sell is something you’ve manufactured or produced, you may have to purchase a product ID. You may choose to purchase a GTIN, UPC or EAN from GS1 here. If you choose to purchase an ISBN, consult the appropriate authority by country through using the ISBN lookup tool

3. The item must have a Variant Group ID, Variant Attribute Name, and 'Is Primary Variant' value to be set up correctly on the website

 

What should I do?

Update each appropriate column by following the requirements listed in this guide.  

Common system errors

If there is a technical issue in our system, you may receive a feed error when setting up your item. Wait a day as our system automatically attempts to reprocess your submission every few hours. If we’re unable to process your submission, contact support in Seller Center by selecting the Help button in the menu bar. Be sure to include the Feed ID and the spreadsheet. 

Walmart-fulfilled errors 

1. Hazmat assessment is required

If we’ve identified your item as a potential hazardous material, we'll review it within three business days. To find out which items are considered hazmat, review Hazardous Materials Overview.

 

What should I do?

After three business days, you can check the status by going to the Items on Hold page. You can correct any items with an Action Needed status. If your item has been in review for more than three business days, contact Seller Support.

2. Package dimension information is incorrect

Your item must include information about its depth, width, height and weight.

 

What should I do?

Include measurements for your item or confirm they’re correct. You'll also need measurements for at least two levels of trade item hierarchy (each/inner pack/case/pallet). 

3. PackConfig does not match sellable GTIN

The product ID in the category tab must match one of the GTINs in the trade item hierarchy (each/inner pack/case/pallet).

 

What should I do?

Trade item hierarchy describes how your item is shipped to a WFS fulfillment center and how it’ll ultimately be shipped to customers. In the trade item configurations tab, make sure either each inner pack, case or pallet GTIN matches the product ID from the category tab. For example: if you sell an item in bulk as a case, then the product ID in the first tab should be the same as the case GTIN in the second tab. Review WFS Trade Item Configuration for more detail and examples.

Was this article helpful?

More in Item setup
Item setup methods: Overview
Item setup
Once you’ve completed the three-step account setup process in Seller Center, you can start to build your product listings on Walmart Marketplace in different ways.
Add items in bulk: Full setup
Item setup
In this guide, we’ll show you how to use the Full Setup template to add several items to your Marketplace catalog at once.
Add items in bulk: Upload a spreadsheet
Item setup
In this guide, you’ll learn how to upload a bulk listing report or custom spreadsheet from any marketplace to build your Walmart catalog in Seller Center.
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.

c2025 Walmart. All Rights Reserved  | Privacy Policy