Get the latest insights right in your inbox

How to Add Bulk Items to Walmart Marketplace: Setup by Match and Full Setup Guide

Published: December 11, 2020
Last updated: March 20, 2026

Picture of Marissa Incitti

Marissa Incitti

Marissa Incitti leads research and content at Feedvisor focused on Amazon, Walmart, and the broader e-commerce marketplace ecosystem. Her work covers retail media performance, pricing strategy, and how AI-driven discovery is reshaping how brands compete across marketplaces. Prior to Feedvisor, she worked in content leadership roles at a Fortune Global 500 omnichannel commerce technology company.

Article hero image

Table of Contents

Why Most Sellers Overcomplicate Walmart Bulk Upload

Most sellers approaching Walmart’s bulk listing process treat it like Amazon’s flat file - and waste hours debugging issues that don’t exist. Walmart’s system is simpler in some ways and more rigid in others.

The core question isn’t how to upload - it’s which upload method to use. If you’re selling on Walmart Marketplace and your products already exist in Walmart’s catalog, Setup by Match gets you listed with minimal data entry. If you’re bringing new products that don’t have existing Walmart listings, you need the Full Item Spec. Mixing these up - or trying to force new items through the match path - is the single most common mistake, and it’s the one that generates the most cryptic error reports.

The math makes this decision simple: single-item setup runs about 2 minutes per SKU through the Seller Center interface. Setup by Match drops that to roughly 30 seconds per SKU once the spreadsheet is built. At 300 SKUs, that’s about 10 hours of clicking vs. 2.5 hours of spreadsheet work - a full workday difference. If you’re listing more than 10-15 items that already exist on Walmart.com, the bulk path wins. Below that, the single item setup is less hassle.

Walmart’s Three Listing Methods - and When Each One Makes Sense

Pick your lane first - Walmart gives you three, and choosing wrong is where uploads stall.

Method Best For Volume What You Need
Single Item (Express/Create) Quick additions, testing 1-50 items UPC/GTIN, SKU, price
Bulk Upload - Setup by Match Existing Walmart catalog products Hundreds to thousands Spreadsheet with SKU and product identifiers
Bulk Upload - Full Item Spec New products not yet on Walmart Hundreds to thousands Complete product attributes, images, full descriptions

Express Setup is Walmart’s quick-match tool - search by Item ID, add your SKU and price, live within 1-24 hours. Fine for a handful of items, but it won’t scale.

One nuance most guides skip: content ownership priority. Walmart gives content preference to brand owners and authorized resellers. If you’re a reseller where the brand already controls the listing, you may not be able to update certain fields regardless of what you put in the spreadsheet. That’s not a bug - it’s Walmart’s content hierarchy.

Setup by Match vs. Full Item Spec: Pick the Right Path First

Getting this wrong costs you the most time, so spend 60 seconds on it upfront.

Setup by Match is for products that already exist on Walmart.com. You’re telling Walmart “I sell this too - here’s my SKU and pricing.” The spreadsheet is lightweight: identifiers (UPC, GTIN, ISBN), your SKU, price, shipping weight, fulfillment type. Walmart’s database matches your products to existing listings and sets up your offers.

Full Item Spec is for products not yet on Walmart.com. You’re creating the listing from scratch - product name, description, key features, images, category attributes, everything. The spreadsheet is heavier and the error rate is higher because every required field must be correct for your specific category.

The practical rule: run your UPCs through Walmart’s catalog first. If 80%+ match existing items, start with Setup by Match for those and use Full Item Spec only for the remainder. Don’t force everything through one path.

If you’re choosing between seller-fulfilled and Walmart Fulfillment Services (WFS), decide before filling out the spreadsheet. WFS gives your items the “Fulfilled by Walmart” tag and faster shipping eligibility, which directly impacts search visibility. Changing fulfillment item by item after upload is tedious across hundreds of SKUs. WFS isn’t automatic, though - you need approval and products must meet size and weight requirements.

Step-by-Step: Bulk Upload via Setup by Match

The Seller Center navigation path is now Catalog > Add Items > Upload in bulk > Match items (the old “Items and Inventory” menu was reorganized in 2025).

  1. Download the template. Click “Build spreadsheet” and download the Match template. It generates a spreadsheet tailored to your selected category.

  2. Enable macros when you open the file in Excel. The macros flag empty required fields in red when you save - catching errors before upload rather than after.

  3. Fill required fields. At minimum: Product ID (UPC/GTIN/ISBN), your SKU, price, and shipping details. Use Special Paste > Values if copying data from another file. Pasting with formatting can corrupt field validation.

  4. Choose your fulfillment method for each item - Seller Fulfilled or WFS. This affects shipping SLAs and your seller performance metrics.

  5. Save as XLSM or XLSX. Other formats get rejected. Walmart caps file size at 5 MB, so split larger catalogs across multiple uploads.

  6. Upload. Drag and drop your file or browse. Hit Submit.

  7. Monitor the Activity Feed (previously called Feed Status). You’ll see items submitted, processed, pending, and errors. Small batches (under 100 items) typically process within a few hours; larger uploads can take up to 24 hours.

Get your SKU and Product ID right the first time. Changing either later requires separate processes through Seller Help - doable but tedious at scale. See Walmart’s guides on Updating an Item’s SKU and Updating an Item’s Product ID.

Full Item Spec: What’s Different When You’re Building Listings From Scratch

The mechanics are the same - download a template, fill it out, upload - but the detail required is substantially more. Navigate to Catalog > Add Items > Upload in bulk > New items.

The template asks for complete product content: product name (50-75 characters with keywords), description (150+ words), up to 10 key features (80 characters each), brand, images, and category-specific attributes. Download the right category template - each has different required fields.

Two gotchas that trip up sellers consistently:

Image URLs. If you’re hosting images on Walmart’s internal SFTP, format the Main Image URL as: partnerId/dirname/imagefilepathname. Walmart’s validation may flag it as an invalid URL - ignore that; it uploads correctly. Broken image URLs from external hosting, though, will reject silently.

Compliance fields. If you mark “Has Warranty” as Yes, you must provide a warranty URL. Missing compliance data causes rejections that don’t surface immediately - they show up later in the Activity Feed as errors without obvious explanations. Check the compliance section carefully before upload.

For shipping, your global settings apply by default. Override specific products using Walmart’s Create Shipping Overrides process if needed.

Managing hundreds of Walmart SKUs alongside your Amazon catalog? Feedvisor’s AI-driven platform helps sellers optimize pricing and advertising across marketplaces - so your Walmart expansion doesn’t come at the cost of Amazon performance. Learn how Feedvisor works across channels.

Fixing Upload Errors Without Losing Your Mind

Errors are normal. Budget for them. Walmart’s bulk upload is pickier about formatting than most sellers expect, and first-time uploads rarely go through clean.

The most common culprits:

  • Missing required fields - macros catch the obvious ones, but conditional fields (required only when another field has a certain value) are easy to miss
  • Invalid Product IDs - your UPC/GTIN must exist in GS1’s database. Misprints, expired codes, and recycled barcodes all cause rejections
  • Image URL formatting - broken URLs or unsupported hosting formats
  • Template modification - adding, removing, or reordering columns from Walmart’s template breaks validation entirely

To diagnose: in the Activity Feed, click the error count to see per-SKU descriptions. Download the error report as a CSV for bulk review.

For unmatched items in a Setup by Match upload, move those SKUs to a Full Item Spec spreadsheet and re-upload with complete product information. Don’t re-upload through Setup by Match hoping for a different result - it won’t find a match the second time either.

Successfully processed items move to “Staged” (pre-launch) or publish automatically if you’re live. If products stay unpublished, check the Unpublish Reasons in the Item Report - common causes include pricing issues, missing content, or seller fee misconfiguration.

What Changed in Seller Center (2025-2026)

Walmart reorganized Seller Center in 2025 - two changes matter for bulk uploads, and one new tool is worth knowing about.

Navigation. “Items and Inventory > Add New Items” is now “Catalog > Add Items.” Same functionality, different menu.

AI-Assisted Content Generation. Walmart added an AI writing assistant for product names, descriptions, and key features. Click “Help me write,” provide a brief description and images, and it generates copy. Use it to draft bullets, then strip the generic adjectives and tighten to actual product benefits. The AI output alone won’t differentiate your listing.

Pro Seller Program (updated September 2025). Walmart revamped Pro Seller with a tiered Price Competitiveness Score and Pro Listings discounts. The badge sounds appealing until you check the requirements: maintaining competitive pricing across tiered benchmarks while hitting performance metrics consistently. But the visibility boost is real - and listing quality feeds directly into eligibility, so cutting corners during bulk upload can cost you more than a rejected file.

Walmart Seller App. Match items via mobile - scan barcodes, add details, monitor status. But it only handles matching to existing catalog items. Bulk uploads require desktop Seller Center.

FAQ

Can I upload both new and existing products in one spreadsheet?

No. Setup by Match and Full Item Spec are separate templates with different required fields. Split your catalog and run two uploads.

What file formats does Walmart accept for bulk upload?

XLSM and XLSX. Walmart’s template uses macros for field validation, so XLSM is recommended. XLS, CSV, and other formats will be rejected. Maximum file size is 5 MB - split larger catalogs across multiple files.

How long does bulk upload processing take?

It depends on volume. Under 100 items usually processes within a few hours. Larger uploads can take up to 24 hours. Items show as “Processing” in Manage Items, then move to “Staged” or publish automatically.

What’s the difference between Setup by Match and Express Setup?

Same matching logic, different scale. Express Setup adds items one at a time through the Seller Center interface. Setup by Match is the bulk version - spreadsheet upload for hundreds or thousands of items at once.

Do I need a UPC for every product?

Yes. Both methods require a valid product identifier (UPC, GTIN, EAN, or ISBN). Walmart validates against GS1’s database - made-up or recycled barcodes fail. If you’re new to Walmart, make sure your application to sell is approved and your identifiers are GS1-registered before starting.

Run your UPCs against the catalog. If 80%+ match, Setup by Match is your starting template - push the rest through Full Item Spec. Decide WFS vs. seller-fulfilled before you touch any spreadsheet, enable macros, and budget 20 minutes for error triage on your first pass.

Your Walmart Expansion Shouldn't Be Held Back by Upload Errors

INTEGRATED SOLUTION

Drive and Convert Demand With Integrated Pricing and Advertising