Amazon SP-API Listing Attribute Changes Take Effect April 27: What Sellers Need to Update
Amazon will enforce new listing attribute rules and refreshed enumeration values via the SP‑API on April 27 2025. Fields like “material” for apparel become required, “brand” for generic accessories becomes optional, and battery‑type lists add “Li‑Polymer” while dropping “Ni‑Cd”.
Overview
Amazon will enforce a new set of listing attribute rules and refreshed enumeration values across its Selling Partner API (SP‑API) on April 27 2025. The update applies to all product types and marketplaces that use the Listings Items API or the JSON LISTINGS FEED. Sellers and developers who rely on these endpoints must adjust their integration before the deadline or face feed rejections and downstream workflow failures.
Key Points
- Effective date — All changes become mandatory on April 27 2025, giving sellers roughly three months to revise their systems.
- Mandatory‑optional swap — Attributes that were optional for certain product categories (e.g., “material” for apparel) will be required, while some currently required fields (e.g., “brand” for generic accessories) will become optional.
- Enumeration refresh — Dropdown lists such as “battery type” for electronics will gain new options like “Li‑Polymer” and retire outdated entries such as “Ni‑Cd”.
- Global reach — The modifications affect every major Amazon marketplace, from North America to Europe and Asia, for all listed product types.
- Scope limitation — Only listings submitted via the Listings Items API or the JSON LISTINGS FEED are impacted; XML feeds, flat‑file uploads, and the Seller Central UI remain unchanged.
- Developer focus — Private and public developers maintaining SP‑API integrations, as well as sellers using third‑party JSON feed tools, must verify compliance.
What's Changing
- Attribute requirement shift — The system will validate that newly mandatory fields are present. For example, a clothing listing that previously omitted “material” will now be rejected unless the field is supplied.
- Enumeration value update — Predefined value lists are being expanded or pruned. A gadget seller who continues to send “battery type = Ni‑Cd” will encounter an error because that option has been removed; the correct entry would be “Li‑Ion” or the newly added “Li‑Polymer”.
- Metadata reference refresh — Amazon’s product metadata catalog will be updated, and the SP‑API will return the latest schema definitions. Integrations that hard‑code allowed values must pull the new definitions to stay in sync.
Analysis & Recommendations
Why This Matters
From April 27 2025, any JSON LISTINGS feed or Listings Items API call missing newly mandatory attributes will be rejected, disrupting product visibility across all Amazon marketplaces. Enumerations that still use retired values like “Ni‑Cd” will also trigger errors, forcing sellers to revise code and data sources now to avoid downtime.
Key Takeaways
- Effective date is April 27 2025, giving roughly three months to adjust integrations.
- The “material” attribute for apparel shifts from optional to required; missing it will cause rejection.
- Battery‑type enumeration adds “Li‑Polymer” and removes “Ni‑Cd”, requiring updates to value tables.
- Only Listings Items API and JSON LISTINGS FEED are affected; XML feeds and Seller Central UI remain unchanged.
Recommended Actions
- →Update your integration to pull the latest schema from the SP‑API Listings Items metadata endpoint and add any newly required fields (e.g., material).
- →Replace hard‑coded enumeration lists with the current values downloaded from the SP‑API metadata service, swapping “Ni‑Cd” for “Li‑Polymer”.
- →Submit test listings for each affected product type in the SP‑API sandbox (sandbox.amazon.com) before April 27 2025 to verify acceptance.
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!