Product Type Definition Changes - XSD to JSON migration requirements
This communication follows up on attribute requirement changes implemented across Amazon's listing experiences that affect the creation and editing of product listings across all global stores. As developers migrate from legacy feed types (XML & flat files) to JSON-based Listings Items APIs, they will see updated attribute requirements designed to improve overall experience and data quality.
Amazon regularly updates attribute requirements to ensure data quality and improve the overall listing creation experience. Specific attributes that were optional in XSD schemas are now required or conditionally required in the JSON-based Product Type Definitions. These updates affect all product types across all global stores. Find the list of attributes with updated requirements below.
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.