Overview

Amazon is updating the SP‑API listing attribute rules, with the changes taking effect on June 29, 2025. Several fields that were previously optional will become required for certain product types, and the list of selectable values for many attributes will be expanded. Sellers who rely on automated listing feeds must adjust their integrations before the cut‑over, or their API calls will be rejected.

Key Points

• Mandatory fields added — Attributes such as “Material” for apparel or “Battery Type” for electronics will shift from optional to required for the listed categories, meaning extra data must be supplied at creation time.
• More enumeration options — Dropdown menus for attributes like “Finish” or “Color” will include additional precise choices (e.g., “Matte Black” vs. generic “Black”), allowing finer product description.
• Hard validation enforcement — After June 29, any JSON_LISTINGS_FEED or Listings API request missing a newly required field will be denied with a validation error, halting the listing or update.
• Marketplace‑specific rules — The United States marketplace may demand “Country of Origin” for toys, while the German marketplace will require “Energy Efficiency Class” for appliances, reflecting regional regulations.
• Feed type alignment — The JSON_LISTINGS_FEED feed will mirror the API’s new schema, so developers must update both the API payload and the feed definition simultaneously.

How the SP‑API Listing Attribute Changes Work

1. Identify newly required attributes — Review the SP‑API product metadata changelog for each affected product type; for example, a “Running Shoe” listing now needs a “Shoe Width” field that was previously optional.
2. Collect the extra data — Modify your inventory management system to capture the new information at the point of data entry; a vendor might add a mandatory “Battery Capacity” field for all power‑bank SKUs.
3. Update the API payload — Insert the required fields into the JSON request body, using the expanded enumeration values where applicable; a “Coffee Maker” listing would now include “Water Reservoir Capacity” set to “1.5 L” from the new list.