September Updates to Listing Attribute Usage and Enumeration Values
Amazon is implementing a technical overhaul of product metadata for the Listings Items API v2021-08-01 and JSON_LISTINGS_FEED. Mandatory compliance for new attribute and enumeration standards begins September 28, 2026.
Back to All Effective September 28, 2026, Amazon will update the attribute usage and enumeration values of numerous product types across Amazon stores. For a complete list of metadata channges and affected Amazon stores, refer to SP-API product metadata changes.
Who is affected?
Both private and public developers who use the Listings Items API v2021-08-01 and JSON_LISTINGS_FEED feed type to create and edit products with offers are affected by this change. Product-only listings, XSD feed uploads, and XML feed uploads are not affected by this change.
What action is required?
This change takes effect when you create or edit listings for products with offers. It requires you to provide values for the newly added attributes with required usage. For attributes with optional usage, you can choose to provide values. You can choose to use an enumeration from the new list in the dropdown values for attributes if the new enumeration is more relevant to the product you are selling.
Analysis & Recommendations
Why This Matters
Sellers using programmatic workflows will face rejected API calls if they do not update their data mapping to match new mandatory attributes and refined enumeration values. Failure to adapt by the 2026 deadline will result in an inability to manage affected product catalogs.
Key Takeaways
- The update specifically targets the Listings Items API v2021-08-01 and the JSON_LISTINGS_FEED submission method.
- Mandatory compliance for all applicable product updates is set for September 28, 2026.
- XML-based feeds, XSD-based uploads, and product-only listings are exempt from this specific metadata transition.
Recommended Actions
- →Audit all codebases and third-party software utilizing the Listings Items API v2021-08-01 to identify susceptible product categories.
- →Update internal database mapping logic to align with new Amazon enumeration values (e.g., changing 'Dark Green' to 'Forest Green').
- →Use Amazon's sandbox testing environments to simulate how the new schema requirements affect current data submissions.
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!