Walmart feed errors

Walmart feed error: product type not found or mismatched

Everything in your item looks filled in, but Walmart still can't process it — because it can't resolve the item's product type. Here's what that means and how to fix it.

Why the product type matters so much

On Walmart Marketplace, the product type is what decides which rules apply to the item — which attributes are required, which values are allowed, and which formats are expected. If the product type on an item doesn't match a known type, Walmart has no ruleset to validate against, so the item can't publish. Everything downstream depends on getting this one field right.

Common causes

• A typo or wrong label — e.g. Shirt instead of Shirts, or a made-up product type that isn't in Walmart's taxonomy.
• Case, spacing, or punctuation differences — shirts, Shirts (trailing space), or Shirts & Tops can all fail to match the exact expected type.
• Wrong schema version — the item uses a product type that exists in a different spec version than the one you're validating or submitting against.
• Mismatched key in the payload — the product-type key under Visible doesn't match the type the rest of the item was built for.

What it looks like in the payload

The product type is the key under Visible. Here it's misspelled as Shirt, so it won't match the real Shirts type:

{
  "Visible": {
    "Shirt": {
      "brand": "Acme",
      "shortDescription": "Classic cotton crew-neck tee"
    }
  }
}

How to fix it

1. Confirm the exact product-type name from Walmart's spec for the category you're listing in.
2. Make the product-type key under Visible match it exactly — spelling, case, spacing, and punctuation all count.
3. Make sure you're validating against the same schema version the item was built for.
4. Check for the same mismatch across items — a bad category mapping usually affects a whole batch, not one product.