Catalog API now returns compare-at prices as `list_price`

The Catalog API now returns a merchant’s compare-at price as list_price on each product variant. Your app or agent can use list_price to tell when a product is marked down and by how much. The price field doesn’t change. No action is required.

list_price is an optional field defined in the UCP catalog specification, version 2026-08-25. It uses the same Price object as price, with amount in minor units and a currency. Products also return list_price_range, which includes the lowest and highest list_price across their variants.

A variant includes list_price when all of the following are true:

• The merchant shares compare-at prices through Catalog Mapping in the Shopify admin. Shopify turns this on by default for most stores and turns it off for stores that use compare-at for MSRP or another reference price.
• The compare-at price is higher than price for the buyer’s context.
• The merchant shows compare-at prices in the buyer’s region. Stores that hide them from EEA buyers don’t return list_price to those buyers.

When list_price is missing, the variant has no compare-at price to show for that buyer and configuration. How you present that in your UI or in an agent’s response is up to you.

Learn how list_price appears in Global Catalog responses.