top of page

Mapping Your SKUs

v1.0

SKU mappings are the connection between your Shopify products and your Walmart WFS inventory. Every product that will be fulfilled by Walmart must have a mapping — without one, the app cannot submit it to Walmart and the order will enter an EXCEPTION state.

How auto-matching works

When you connect your Walmart account (or click Import Shopify, Import Walmart, and Run Matching in the Catalog page), the app tries to match your Shopify variants to Walmart items automatically.

There are three matching strategies, configured in Settings → Inventory & Catalog → Product Matching:

• Strategy: How it works
• Match by SKU (default): Compares the Shopify variant SKU field to the Walmart item SKU. Best for most sellers.
• Match by Barcode: Compares the Shopify variant barcode to the Walmart item UPC/GTIN. Use when SKUs differ between platforms.
• Barcode first, then SKU: Tries barcode match first; falls back to SKU match if no barcode match is found.

Checking auto-match results

• Go to Catalog in the navigation
• Click the Import Jobs tab — wait until all three jobs (Shopify Import, Walmart Import, SKU Matching) show a COMPLETED status
• Click the Shopify Products tab to see all your variants with their match status (Matched / Unmatched)
• Click the Unmatched tab to see only the variants that need manual mapping

Mapping unmatched products manually

On the Unmatched tab in Catalog:

• Find the product that needs mapping
• In the Map Walmart SKU column, type the correct Walmart SKU for that variant
• Press Enter or click Save

The mapping is saved immediately and the product moves off the Unmatched list.

You can also add mappings from the SKU Mappings page:

• Go to SKU Mappings in the navigation
• Click Add Mapping
• Select the Shopify variant from the dropdown
• Enter the Walmart SKU
• Click Save

Where to find Walmart SKUs

Your Walmart item SKUs are visible in:

• Walmart Seller Center → Manage Items → your item listing
• The Walmart Products tab in the app's Catalog page (after running a Walmart import)

What happens with unmapped SKUs

If an order comes in with a product that has no SKU mapping:

• The order is saved with an EXCEPTION status immediately
• An error appears on the order: "Unmapped Shopify variant IDs: [...]. Add SKU mappings in Catalog → Unmatched, then retry the order."
• After adding the mapping, go to Orders, find the order with EXCEPTION status, and click Retry

Removing a mapping

On the SKU Mappings page, find the mapping row and click Remove. The mapping is deleted immediately. If the product is later re-imported, it will appear again in the Unmatched tab.

bottom of page