← All guides

Walmart feed errors

Walmart feed error: invalid value for an attribute

Your attribute is present, but Walmart still rejects it — because the value isn't one of the allowed options for that field. Here's why, and how to fix it.

What the error means

Many Walmart attributes are closed lists (enums): the item spec defines an exact set of accepted values, and anything outside that set is rejected. Color, material, gender, and unit-of-measure fields are common examples. A typical message looks like:

Attribute "color" value "Navy Blue" is not allowed. Valid values: "Blue", "Black", "White", "Red", "Green".

The value "Navy Blue" is perfectly reasonable English — it just isn't in Walmart's accepted list for this product type, so it fails. These lists are also case- and spelling-sensitive: blue, BLUE, and a trailing space after Blue are all different from the accepted Blue.

What it looks like in the payload

{
  "Visible": {
    "Shirts": {
      "brand": "Acme",
      "color": "Navy Blue"
    }
  }
}

Here color is set to "Navy Blue", which isn't one of the accepted values for this product type — so the item is rejected even though the field is present and filled in.

How to fix it

  1. Read the rejected value and the list of valid values from the error message.
  2. Map your value to the closest exact accepted option — here, "Navy Blue""Blue".
  3. Match capitalization and spelling exactly, and trim stray whitespace.
  4. Watch for the same bad value repeated across many items — enum errors usually come from a spreadsheet column or mapping rule that produced one non-standard value everywhere.

The full list of accepted values for each attribute lives in the item-spec schema file for that product type (downloadable from the Walmart Developer Portal). When in doubt, the schema — not guesswork — is the source of truth for what's allowed.

Catch invalid values before Walmart does

SellerFlow Feed Workbench checks each attribute against the allowed-value list in your imported schema and tells you the offending value and the accepted options — for every item at once, locally in your browser, before you upload.

Get SellerFlow on Chrome
SellerFlow is an independent tool and is not affiliated with, endorsed by, sponsored by, or operated by Walmart Inc. Walmart, Walmart Marketplace, and related marks are trademarks of Walmart Inc. Validation results depend on the schema version you import and do not guarantee Walmart feed approval.