Update: March updates to listing attribute usage and enumeration values
Effective March 30 2026, Amazon’s SP‑API will require new mandatory attributes—e.g., materialComposition for clothing and batteryCapacity for electronics—and add enumeration options such as neonGreen, XXXL, and recyclable. Listings Items API and JSON_LISTINGS_FEED users must call getProductTypeDefinitions, update payloads, and run validateListingItem before the deadline to avoid rejections.
Back to All Effective March 30, 2026, Amazon will update the attribute usage and enumeration values of numerous product types across marketplaces. For a complete list of metadata changes and affected marketplaces, refer to SP-API product metadata changes.
Who is affected?
Both private and public developers who use the Listings Items API and JSON_LISTINGS_FEED feed type to create and edit products with offers are affected by this change. Product-only listings and XSD/XML feed uploads are not affected by this change.
What action is required?
This change affects how you create or edit listings for products with offers. You must provide values for the newly added required attributes. 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
Missing the new mandatory attributes or using invalid enum values will cause the Listings Items API to reject submissions, leading to listing downtime and lost sales across every Amazon marketplace after March 30 2026. Updating now ensures compliance, improves product discoverability, and prevents costly suspensions.
Key Takeaways
- materialComposition becomes a required attribute for clothing categories starting March 30 2026.
- batteryCapacity is now mandatory for electronic device listings.
- Color, size, and packagingType enums now include new values like neonGreen, XXXL, and recyclable.
- Developers must use getProductTypeDefinitions and validateListingItem SP‑API operations to fetch schemas and pre‑validate listings.
Recommended Actions
- →In your integration, add a step to call the SP‑API getProductTypeDefinitions endpoint for each product type and store the latest schema.
- →Update your payload builder to include materialComposition for apparel and batteryCapacity for electronics, pulling values from your product data.
- →Before sending createListingItem or uploading JSON_LISTINGS_FEED, invoke validateListingItem (or the feed validator) and correct any errors reported.
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!