Update: May updates to listing attribute usage and enumeration values
Starting May 25 2026 Amazon will enforce a new attribute schema for Listings Items API and JSON LISTINGS FEED. Duplicate fields like materialType/fabricComposition are merged, new required attributes such as batteryLife and energyStarRating are added, and enumeration lists (e.g., colors) are refreshed with values like Crimson, Navy and Olive.
Overview
Starting May 25 2026, Amazon will change the rules that govern product‑type attributes and the lists of allowed values for many categories. The revision removes overlapping fields, adds new mandatory attributes where gaps were found, and refreshes dropdown options such as color or material. Sellers who use the Listings Items API or the JSON LISTINGS FEED for offer‑linked listings must revise their payloads before the deadline to keep their feeds accepted.
Key Points
- Effective date — The new schema becomes active on May 25 2026, giving sellers a fixed cut‑off to adjust their integrations.
- Attribute consolidation — Duplicate fields are eliminated; for example, “materialType” and “fabricComposition” on apparel are merged into a single required attribute.
- New mandatory fields — Categories such as electronics, home appliances, and outdoor gear now have additional required attributes like “batteryLife” or “energyStarRating.”
- Enumeration refresh — Predefined value lists are updated; a color attribute that previously offered “Red” and “Blue” now includes “Crimson,” “Navy,” and “Olive,” while removing outdated entries.
- Scope of impact — Only the Listings Items API and the JSON LISTINGS FEED that handle listings with associated offers are affected; product‑only listings and XSD/XML uploads stay unchanged.
- Optional attributes — Fields still marked optional can be omitted, but providing them may improve search relevance and conversion rates.
How the Updated Attribute System Works
-
Determine required fields — When a create or update request is sent, Amazon validates the JSON payload against the latest attribute schema.
- Example: A seller listing a new smart‑watch must now include the “batteryLife” attribute because Amazon has promoted it from optional to required for the “Electronics > Wearable” type.
-
Retrieve current enumeration sets — For each attribute that uses a controlled vocabulary, the API returns the refreshed list of permissible values.
Analysis & Recommendations
Why This Matters
After the May 25 2026 cut‑off any listing that lacks the newly mandatory fields will be rejected, leading to lost sales and extra remediation effort. Updated enumerations also mean existing values like “Purple” will cause errors, so sellers must align their catalogs now to maintain listing uptime.
Key Takeaways
- Effective date is May 25 2026; listings missing new required attributes will be rejected.
- Apparel material attributes are consolidated into a single required field named “material”, replacing “materialType” and “fabricComposition”.
- New mandatory fields include “batteryLife” for electronics and “energyStarRating” for home appliances.
- Color enumeration now offers “Crimson”, “Navy”, “Olive” and removes outdated entries such as “Purple”.
Recommended Actions
- →Run a schema audit script against the Amazon attribute reference endpoint (https://sellingpartnerapi-na.amazon.com/definitions/v2020-09-01/attribut...
- →Update your Listings Items API integration to fetch the latest enumeration JSON (GET /enumerations) and validate payload values before submission.
- →In Seller Central, go to Inventory > Add Products via Upload > JSON Listings Feed, upload a sandbox test file that includes batteryLife and the ref...
Comments
Join the discussion
Log in or create an account to share your thoughts on this update.
No comments yet. Be the first to share your thoughts!