Update: April updates to listing attribute usage and enumeration values
Effective 27 April 2026, Amazon will enforce new attribute rules for the Listings Items API and JSON LISTINGS FEED. New mandatory fields such as BatteryVoltage and BatteryCapacity for power tools and FabricContent for blended‑fiber apparel will cause listings to be rejected if omitted. Updated enumeration lists add values like “Midnight Blue” for Color and drop obscure shades such as “Dusty Olive”.
Overview
On April 27 2026 Amazon will enforce a comprehensive overhaul of attribute rules and enumeration lists across dozens of product categories on every marketplace. The revision eliminates redundant fields, tightens the set of required attributes, and refreshes dropdown options to better reflect real‑world product specifications. Sellers and developers who use the Listings Items API or the JSON LISTINGS FEED must update their integration before the cut‑over to keep listings active.
Key Points
- Effective date — All listings created or edited after 27 April 2026 must conform to the new schema, or they will be rejected.
- Affected integrations — The change applies to private and public developers using the Listings Items API or JSON LISTINGS FEED; pure product‑information uploads via XSD/XML remain unchanged.
- New required fields — Certain categories now demand additional data, such as “Battery Capacity” for rechargeable power tools and “Fabric Content” for blended‑fiber apparel.
- Expanded optional values — Optional attributes like “Seasonality” for home décor now accept new enumeration entries such as “Holiday 2024” and “Back‑to‑School”.
- Enumeration cleanup — Dropdown lists have been trimmed and regrouped; for example, the “Color” list for electronics now includes “Midnight Blue” and drops obscure shades like “Dusty Olive”.
- Stricter validation — Amazon’s backend will block any payload missing a newly mandatory attribute or containing a value outside the refreshed enumeration set.
How the Attribute Update Works
-
Identify impacted product types — Review the SP‑API product‑metadata change log to pinpoint categories with added requirements; a seller listing a cordless drill, for instance, must now provide a “Battery Voltage” attribute.
-
Modify the request payload — Insert the new mandatory fields into the JSON LISTINGS FEED or Listings Items API call. Example:
{ "productType": "CordlessDrill", "attributes": { "BatteryVoltage": "18V", "BatteryCapacity": "2.0Ah" } }
Analysis & Recommendations
Why This Matters
Listings that miss the new required attributes or use deprecated enumeration values will be rejected after 27 April 2026, leading to product visibility loss and potential sales impact. The overhaul touches dozens of categories, so sellers must adjust their integration code and validation processes now to avoid downtime.
Key Takeaways
- Effective date is 27 April 2026; any listing created or edited after this will be rejected if it doesn't follow the new schema.
- New required attributes include BatteryVoltage and BatteryCapacity for power tools and FabricContent for blended‑fiber apparel.
- Enumeration lists are refreshed: Color for electronics now includes “Midnight Blue” and removes “Dusty Olive”; Seasonality now accepts “Holiday 202...
- Amazon provides a ValidateListing endpoint and feed pre‑validation mode to catch missing attributes before submission.
Recommended Actions
- →Update your Listings Items API payloads (or JSON LISTINGS FEED generator) to add the new mandatory fields (e.g., BatteryVoltage, BatteryCapacity) f...
- →Pull the latest enumeration definitions from the SP‑API metadata endpoint (GET /catalog/v0/definitions) and replace any hard‑coded dropdown values ...
- →Run pre‑submission validation using the SP‑API ValidateListing endpoint or the feed's pre‑validation mode in the sandbox before 27 April 2026 to en...
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!