Changelog

August 4, 2026

The Promotions API now supports featured promotion callouts, letting you highlight promotions on storefront product pages with a short customer-facing message.

  • is_featured_promotion — new boolean field on automatic promotions that marks a promotion as featured. Featured promotions evaluate at the highest priority within their category. A store can have a maximum of 5 featured promotions.
  • featured_promotion_callout_message — a short message (up to 80 characters) displayed alongside targeted products on the storefront.
  • promotion_category — read-only field indicating whether a promotion is categorized as cart or shipping, based on its discount type.
  • is_featured query parameter — filter the Get Promotions endpoint by featured status.
  • Stencil featured_promotions context — a new featured_promotions array on the Product object provides the promotion ID, callout text, priority, and category for rendering featured promotion badges on product detail pages, category listings, brand pages, and search results.

For details, see Get Promotions and Stencil object schemas.