Amazon SP-API Listing Attribute Changes Take Effect August 24: How to Prepare
Amazon will enforce new listing rules on August 24 2025, making ItemPackageQuantity and CountryOfOrigin mandatory and replacing enum values like "Other" with options such as "Eco‑Friendly". Feeds missing these fields or using deprecated codes will be rejected, risking listing suppression during Q4.
Overview
Amazon will enforce new product‑listing attribute rules on August 24 2025 across every marketplace. The update makes several previously optional fields mandatory and refreshes dropdown (enumeration) values for many attributes. Sellers and developers who use the SP‑API or the JSON_LISTINGS_FEED must adjust their integrations now to avoid validation failures during the busy back‑to‑school and pre‑holiday season.
Key Points
- Mandatory fields added — Attributes such as “ItemPackageQuantity” and “CountryOfOrigin” will shift from optional to required for any offer‑linked listing; a submission that omits them after 24 Aug 2025 will be rejected.
- Enumeration overhaul — Values like “Color” and “Material” will drop obsolete options (e.g., “Other”) and introduce new selections (e.g., “Eco‑Friendly”), meaning feeds that still send the old codes will fail validation.
- Global rollout — The rule change applies to North America, Europe, Brazil, Egypt, Turkey, Saudi Arabia and all other Amazon locales, so a single integration must accommodate every market.
- Scope limited to offer listings — Pure product‑only entries and XSD/XML uploads remain exempt; only listings that include an offer and are submitted via SP‑API or JSON_LISTINGS_FEED are affected.
- Risk of suppression — Missing required attributes or using deprecated enumeration values will trigger feed errors that can suppress listings, potentially cutting sales during the high‑traffic Q4 ramp‑up.
- Opportunity for optimization — The new enumeration choices often describe products more precisely, giving sellers a chance to improve search relevance while they comply.
How Listing Attribute Changes Work
- Metadata refresh — Amazon publishes an updated product‑type definition file via the SP‑API metadata endpoint. Example: A seller querying the “Clothing” type on 15 July 2025 will receive a JSON schema that now lists “FabricContent” as required and adds “SustainableMaterial” to the “Material” dropdown.
- — When a seller submits a JSON_LISTINGS_FEED payload after 24 Aug 2025, Amazon’s validation engine cross‑checks each SKU against the refreshed schema. : A feed that still sends “Color”: “Other” for a kitchen gadget will be flagged and rejected with an error code indicating an invalid enumeration.
Analysis & Recommendations
Why This Matters
A missing CountryOfOrigin or outdated enum triggers feed errors that can suppress listings, cutting sales during the high‑traffic back‑to‑school and holiday periods. In a 12,000‑SKU catalog, an audit may flag ~1,850 items lacking the new required fields, requiring immediate correction to stay visible.
Key Takeaways
- Effective date is August 24 2025 for all Amazon marketplaces.
- ItemPackageQuantity and CountryOfOrigin shift from optional to required for offer‑linked listings.
- Enumeration values like "Other" are removed; new options include "Eco‑Friendly" and "RecyclablePlastic".
- Feeds submitted after the date will be rejected with errors such as "Error #E123: Missing required attribute 'CountryOfOrigin'".
Recommended Actions
- →Run a catalog audit script (e.g., in Seller Central > Reports > Inventory) to flag SKUs missing ItemPackageQuantity or CountryOfOrigin and prepare ...
- →Update integration code to call the SP‑API metadata endpoint nightly (GET /definitions/productTypes) and replace hard‑coded enums with the latest s...
- →Submit a test batch of ~200 SKUs to the SP‑API sandbox (Feeds > Submit Feed) and fix any validation errors before the production rollout.
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!