Shopify Admin GraphQL API Adds Market Targeting to Discounts
Add the markets field to DiscountContextInput to target discounts by market, and update queries to include market eligibility.
Patch your integration to include markets in DiscountContextInput, update queries to handle market eligibility, and test against API version 2026‑07 or later.
Summary
Shopify has added a new markets option to the DiscountContextInput object in its Admin GraphQL API, allowing developers to target discounts to specific regional markets, retail locations, or B2B company locations. The new field can be used alongside existing eligibility options such as all, customerSegments, and customers, but eligibility types are mutually exclusive—markets cannot be combined with customer segments.
The markets option applies to all discount types, including Basic, BXGY, App, and Free Shipping discounts, both automatic and code‑based. Discounts do not inherit across different market types; assigning a discount to a regional market automatically applies it to sub‑markets of the same type (e.g., North America to Canada). API versions before 2026‑07 cannot represent market eligibility, so discounts with this feature will be filtered out in those versions.
Developers can query the discounts and discountsCount fields on a Market to view discount customizations, and filter discounts by any market eligibility using context:market or by specific markets using market_ids in discountNodes.
Key changes
- markets option added to DiscountContextInput for targeting discounts by market, retail, or B2B locations
- eligibility types are mutually exclusive: markets OR customerSegments, not both
- applies to all discount types: Basic, BXGY, App, Free Shipping (automatic and code‑based)
- discounts do not inherit across different market types; regional assignment applies to sub‑markets of same type
- API versions prior to 2026‑07 cannot represent market eligibility and will filter such discounts
- query discounts and discountsCount on Market to view discount customizations
- filter discounts by market eligibility using context:market or market_ids in discountNodes