---
title: Target discounts to specific markets - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: 'https://shopify.dev/changelog/target-discounts-to-specific-markets'
  md: 'https://shopify.dev/changelog/target-discounts-to-specific-markets.md'
metadata:
  effectiveApiVersion: ''
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2026-05-06T15:18:37-04:00'
  postedAt: '2026-05-06T12:00:00-04:00'
  updatedAt: '2026-05-06T17:31:50-04:00'
  effectiveAt: '2026-05-08T12:00:00-04:00'
---

May 6, 2026

Tags:

* Admin GraphQL API

# 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](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/discountcontextinput#fields-markets).