The Catalog API now returns a merchant’s compare-at price as on each product variant. Your app or agent can use to tell when a product is marked down and by how much. The price field doesn’t change. No action is required.
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 , which includes the lowest and highest across their variants.
A variant includes 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
pricefor 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
to those buyers.
When 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 appears in Global Catalog responses.
Was this page helpful?