Overview

Amazon is introducing a comprehensive overhaul of product‑listing metadata that will affect every seller using the Selling Partner API (SP‑API) or the JSON LISTINGS FEED. The change reclassifies several previously optional attributes as mandatory, revises the set of allowed enumeration values, and goes live across all Amazon marketplaces at the same time. Sellers who rely on API‑driven or bulk‑feed workflows must adjust their integrations now to prevent listing rejections.

Key Points

• Optional becomes mandatory — Attributes that were once optional, such as “Material” for apparel or “Battery Type” for electronics, will now be required when a listing is created or updated via the SP‑API or JSON feed.
• Enumeration refresh — Dropdown lists for fields like “Color,” “Size,” and “Package Quantity” are being trimmed, expanded, or renamed; for example, “Medium” may be replaced by “M” and “Large” by “L.”
• All marketplaces at once — The new schema is being deployed simultaneously in North America, Europe, Asia‑Pacific, and other regions, so no market is exempt.
• API and JSON‑feed only — Traditional XML/XSD feeds and manual Seller Central entries are not subject to these rules; only programmatic listings are impacted.
• Search and conversion upside — Listings that meet the richer attribute set are expected to rank higher in Amazon’s search algorithm, potentially boosting visibility and sales.
• Developer‑centric update — The SP‑API’s getProductTypeDefinitions operation will return the revised schema, meaning any hard‑coded attribute maps will become obsolete.

How the Updated Listing Attributes Work

1. Schema retrieval — When a developer calls getProductTypeDefinitions, the response now includes the newly required fields and the refreshed enumeration lists. Example: A request for the “KitchenKnife” product type returns a mandatory “BladeMaterial” attribute that was previously optional.
2. Payload construction — The integration must populate every required attribute before sending a or request.