Amazon SP-API Listing Attribute Changes Take Effect May 25, 2025
Amazon will enforce new mandatory listing attributes for 12 product types on May 25 2025. The SP‑API v2021‑08‑01 and JSON LISTINGS feed will reject payloads missing fields such as materialComposition or warrantyPeriod with a 400 MissingRequiredAttribute error. Sandbox validation starts May 1 2025, giving a ten‑day test window.
Overview
Amazon is updating the product‑type definitions used by the Selling Partner API (SP‑API) on May 25 2025. The revision adds mandatory attributes for several categories and widens the set of allowed enumeration values. Sellers and developers who create or modify listings through the SP‑API or the JSON LISTINGS feed must adjust their integrations before the cut‑off, or their submissions will be rejected during validation.
Key Points
- New mandatory attributes — Twelve product types, such as Clothing, Shoes, Jewelry, and Home Improvement, will now require at least one extra field (e.g., materialComposition or warrantyPeriod) when a new listing is posted.
- Expanded enumeration options — More than 40 categories receive additional dropdown choices; for instance, the Color field for Electronics now includes “Neon Pink” and “Matte Black,” while the Size field for Footwear adds “EU 44” and “EU 45.”
- Simultaneous global rollout — The changes will be applied across 30 Amazon marketplaces, from amazon.com to amazon.co.jp, meaning sellers with inventory in multiple regions must verify each locale’s attribute requirements.
- Scope limited to SP‑API and JSON feed — Legacy XML/XSD feeds and product‑only listings that lack offers remain unaffected; only the SP‑API version v2021‑08‑01 and JSON LISTINGS feed submissions are subject to the new rules.
- Immediate validation failures — Any payload that omits a newly required attribute will trigger a 400 validation error, stopping the feed and preventing the product from appearing on the storefront.
- Sandbox enforcement starts early — Amazon’s sandbox will begin applying the new validation logic on May 1 2025, giving sellers a ten‑day window to test before production goes live.
How SP‑API Listing Attribute Changes Work
- Add required field — When a seller creates a Clothing listing via the SP‑API, the request body must now contain a materialComposition key (e.g.,
"materialComposition": "100% Cotton"). If the key is missing, the API returns an InvalidRequest error with a MissingRequiredAttribute code.
Analysis & Recommendations
Why This Matters
If the new attributes are not added, listings for categories like Clothing, Shoes, Jewelry and Home Improvement will be blocked, causing loss of sales and ad spend. The change applies to all 30 marketplaces, so multi‑region sellers must adjust each locale’s format (e.g., warrantyPeriod in months for US, years for DE).
Key Takeaways
- Effective May 25 2025, 12 product types (e.g., Clothing, Shoes, Jewelry) require an extra mandatory field such as materialComposition or warrantyPe...
- More than 40 categories receive expanded enumeration values, like “Neon Pink” for Electronics Color and “EU 44/45” for Footwear Size.
- Sandbox enforcement begins May 1 2025; missing required attributes trigger a 400 InvalidRequest error with errorCode MissingRequiredAttribute.
- The JSON schema file product‑type‑definitions‑v2025‑05‑25.json must be used for bulk uploads, otherwise schema‑mismatch rejections occur.
Recommended Actions
- →Update your integration code: add materialComposition for all Clothing items and warrantyPeriod for applicable products in the JSON payload builder...
- →Run a sandbox test: in Seller Central, go to Developer Central > SP‑API Sandbox, upload a test batch of 100 listings after May 1 2025 and verify no...
- →Generate an audit report: use Inventory > Manage Inventory > Download Report to list SKUs of the 12 affected product types and flag any missing man...
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!