Target discounts to specific markets

We've introduced markets as a new option in DiscountContextInput, enabling you to target discounts to specific regional markets, retail locations, or B2B company locations. This option can be used alongside existing eligibility options such as all, customerSegments, and customers.

You can now set market eligibility for all discount types, including:

• Basic, BXGY, App, and Free Shipping discounts (both automatic and code-based).
• Note that eligibility types are mutually exclusive—you can target either markets OR customer segments, but not both simultaneously.

What you can do:

• Assign market eligibility to a discount by using markets in DiscountContextInput when creating or updating a discount.
• Query the discounts and discountsCount fields on a Market to view the list of discount customizations for that market.
• Filter discounts by any market eligibility using context:market or by specific markets using market_ids in discountNodes.

What you need to know:

• Discounts do not inherit across different market types (e.g., from regional to B2B or retail). When you assign a discount to a regional market, it automatically applies to sub-markets of the same type (e.g., from "North America" to "Canada").
• If you are using API versions prior to 2026-07, discounts with market eligibility will be filtered out, as these versions cannot represent them (both in node queries and specific discounts by ID).

For more information, refer to the Admin GraphQL API documentation.