Reminder: December 2023 Product Type Definition Changes - XSD to JSON migration requirements
On December 11, 2023, Amazon updated the attribute requirements for creating and editing product listings
across all global stores. This change affects all product types. You can find the list of attributes with updated
requirements below.
Attributes that were optional in XSD schemas are now required in the JSON-based Product Type Definitions. These changes were implemented last year to improve the overall shopping experience and data quality.
Important note: Your existing listings are not affected.
Which marketplaces are affected?
This change applies to the following marketplaces:
- Canada (CA)
- United States (US)
- Mexico (MX)
- Brazil (BR)
- Spain (ES)
- United Kingdom (UK)
- France (FR)
- Netherlands (NL)
- Germany (DE)
- Italy (IT)
- Sweden (SE)
- Poland (PL)
- Egypt (EG)
- Turkey (TR)
- Saudi Arabia (SA)
- United Arab Emirates (AE)
- India (IN)
- Singapore (SG)
- Japan (JP)
- Australia (AU)
- Belgium (BE)
- South Africa (ZA)
Who is affected?
Developers migrating from legacy feed types (XML and flat files) to the JSON-based Listings Items APIs or the
JSON_LISTINGS_FEED are affected by this change. For more information, refer to the deprecated feed type values.
What action is required?
These changes will apply when you create a new listing. When you edit an existing listing, you may be asked to provide additional information to meet the new requirements.
- Refer to the Product Type Definitions API to programmatically fetch the complete list of required and conditional attributes for relevant product types.
- Update your systems to include all mandatory attributes when you create or update listings.
More information:
- For a complete list of the updated required attributes by product type and marketplace, refer to the spreadsheet.
- To learn about implementation and integration of workflows with the Selling Partner API, refer to the Listings Management Workflows Guide.
- Refer to the Updated attributes within the Add Products and Add Products using Upload interface.
- To learn more about the changes to the listings requirement, refer to the announcement.
If you need additional assistance, contact Developer Support.