Listings Management Workflow Migration

❗

Important

Starting July 31, 2025, the Feeds API no longer supports legacy XML and flat file listing feeds, including pricing, inventory, relationships, and images. Developers will receive fatal processingStatus in the getFeed API response for these feeds. For more information, refer to the deprecation announcement.

This guide explains how to migrate listings management workflows from XML and flat file listings submissions to the Listings Items API and JSON_LISTINGS_FEED. This is necessary to prepare for the deprecation of legacy feed types.

Review the Building Listing Management Workflows Guide prior to this migration guide.

Benefits

The guidance offered here describes the following benefits for both sellers and vendors:

• Full data requirements in product schemas
• Availability of pre-submission validation rules
• Sync and async feedback mechanisms
• Up-to-date product type data requirements that ensure you are using the latest version, unlike XMLs
• Uniformity in schemas across data requirements, unlike XML in the past that led to errors for developers uploading multiple categories
• Reducing the effort required to map flat file or XML attributes to Listings APIs and the JSON_LISTINGS_FEED
• Reducing human/manual input errors leading to submission errors and abandoned selections
• Easier management of large catalogs and sending of full selections with no upload constraints

API versions

This guide references operations in the following Selling Partner API sections. For more detailed information about building workflows using these sections, refer to the Building Listings Management Workflows Guide. For more detailed information about the individual API sections, follow the referenced links.

Feed types

This guide references the following feed types used with the Feeds API. For more detailed information about feed types, refer to Listings Feed Type Values.

❗

Important

Feeds API support for XML and flat file product listings feeds is deprecated. For more information about the affected feeds and migration guidelines, refer to the deprecation announcement.

To learn more about the terms that are used on this page, refer to Terminology.