Feature / Admin · Markets

Discounts by Market
Specify, per market, exactly where each discount applies

Assign a discount to one or more markets to control its scope precisely. Keep an online-only flash sale from spilling into your retail stores, and deliver wholesale offers to B2B buyers only. No workarounds needed.

What's on this page
  1. What's changing, in a nutshell (30-second overview)
  2. Three pillars of the new feature (What's new)
  3. How it works: how a discount applies per market
  4. Before vs. Discounts by Market
  5. Requirements
  6. Three places to manage it
  7. Five points developers should know
  8. Three practical use cases
  9. A one-line summary for pitching

1What's changing

Until now, discounts applied store-wide by default, and limiting them to specific sales channels or customer segments required a workaround.
Discounts by Market is a new feature thatlets you assign discounts (both code-based and automatic) directly to one or more markets and control their scope precisely.
ALL

Before: narrowing the scope was hard

If you wanted a discount to apply to specific channels or customer segments only, you needed a workaround (the post sums up this pain point as "No workarounds needed").

New: pick markets and assign

Use the Eligibility selector on the discount detail page to choose one or more markets where the discount should apply. You can finalize its scope with no workarounds.

2Three pillars of the new feature (What's new)

① Eligibility selector on the discount detail page

Both code-based and automatic discounts can be assigned to one or more markets. Set the scope right inside the discount creation screen.

② Market / customer filters in the discount list

Filter the discount list by market, customer segment, or specific customer to quickly grasp what's active where.

③ Discount display on the market detail page

See all discounts assigned to a given market in one list. In the Markets graph view's "View-As" mode, you can preview how discounts resolve in context.

What is View-As mode : A preview feature in the Markets graph view that lets you check in advance how discounts resolve when viewed from a specific market or context. Before pushing settings to production, you can see with your own eyes how a discount applies in each market.

3How it works: how a discount applies per market

Discount Code-based / automatic Created on the discount detail page Target selector ☑ Online market ☑ B2B market ☐ Retail (in-store) market Select the markets where it applies View-As Resolve per market Preview Markets graph view Application results per market Online ... discount applied B2B wholesale ... discount applied Retail ... not applied Control the scope precisely
The key point On the discount-creation side you pick the markets, and on the market-viewing side you can check the assignment status and previewA two-way flow. In the article, three screens—the discount list, the discount detail page, and the market detail page—work in concert.

4Legacy vs. Discounts by Market comparison

ItemLegacyDiscounts by Market
Specifying the applicable scope Requires a workaround Hard to limit it to a specific scope Direct specification Assign to one or more markets
Supported discount types Not specified Both supported Both code-based and automatic
Knowing what is active where Not specified Filter by market / customer segment / specific customers
Previewing the applied result in advance Not specified Preview per-market resolution in View-As mode
Example: online-only sale Tends to spill over to retail too Online market onlycan be limited to it

5Requirements

Basic plan or higher

Available to all merchants on the Basic plan or higher. No additional notes on lower-tier conditions or restrictions specific to higher plans.

The new version of Markets

Assumes you are using the "new version of Markets." Availability on the older version of Markets is not stated.

Supported countries, rollout timing, and whether existing discounts are migrated automatically are not stated in the article. Check Shopify's help documentation for details (the article only points to "Learn more in our help documentation").

6Three entry points for the workflow

* Since the article does not cover specific click-by-click steps, here we organize the three screens (entry points) it explicitly mentions.

1

Filter in the discount list

Narrow down by market, customer segment, or specific customers to see which discounts are active.

2

Assign on the discount detail page

Use the Eligibility selector to choose one or more markets where the discount applies.

3

Review on the market detail page

Review the list of assigned discounts and preview with View-As.

7Five key points for technical teams

CODE AUTO

1. Both code-based and automatic discounts are supported

Market assignment works regardless of discount type. Both coupon campaigns and automatic discounts can be designed on a per-market basis.

2. One-to-many assignment

A single discount can be assigned to "one or more markets." Instead of mass-producing a discount per market, one campaign can cover multiple markets.

3

3. Filtering across three dimensions

The discount list can be filtered across three dimensions—market, customer segment, and specific customers—which directly supports auditing "what is active where" during operations.

4. Validate ahead of time with View-As

The View-As mode in the Markets graph view lets you check how discounts resolve per market before going live, preventing unintended application caused by misconfiguration.

API ?

5. API / Webhook and auto-migration specs are not documented

This article is limited to describing the admin UI feature; how market assignment is handled via the Admin GraphQL / Discounts API and Webhooks, and whether existing discounts are auto-migrated, arenot documented. If you are building automation or bulk configuration, you will need to verify separately using documentation and a sandbox.

8Three use cases you can apply to your operations

ONLINE % Retail ✕
USE CASE 1

Keep an online-only flash sale from spilling over to physical stores

Challenge
You want to run a short-term online-only sale, but previously the discount would also apply at physical stores (POS), risking broken pricing consistency on the floor.
Approach
Assign the discount only to the online market, and exclude the retail market. This maps directly to the article's "online-only flash sale without it hitting your retail locations."
Result
Run online acquisition campaigns while keeping pricing consistent across channels, and eliminate operational mistakes from workarounds.
Technical note
Before going live, use View-As to confirm the discount does not apply to the retail market, then publish.
B2B %
USE CASE 2

Deliver wholesale (B2B) offers only to B2B buyers

Challenge
You do not want wholesale prices or wholesale-only offers shown to general-consumer D2C customers. Mixing channels creates a risk of misapplication.
Approach
Assign the discount only to B2B markets. Verify the targets using the customer segment / specific customer filters in the discount list. Maps to the article's "wholesale offer that only reaches your B2B buyers."
Impact
Run account-based pricing strategies entirely with Shopify's standard features. Cleanly separate wholesale and retail markdowns.
Technical notes
Combining the customer segment and specific customer filters makes it easier to audit who each discount applies to.
Market: JP ▾
USE CASE 3

Periodically take stock of "what's active where" across multi-market operations

Challenge
As markets and customer segments grow, it becomes hard to track which discounts are live where, making duplicate applications and unremoved expired discounts more likely.
Approach
Establish an operational flow that filters the discount list by market / customer segment / specific customer and regularly reviews per-market assignments on the market detail page.
Impact
Discount visibility improves, making it easier to pause and tidy up unneeded discounts. Cuts the effort spent on campaign reviews.
Technical notes
Combining the market detail page list with View-As and sharing the current state as screenshots before the review meeting speeds up reaching consensus.

9One-line summary you can use in a proposal

"A new feature that lets you assign discounts (both code-based and automatic)on a per-market basis and precisely control where they apply."
Online-only sales and B2B-only offers are both possible with no workarounds, and filters plus View-As make it visible "what works where."
Requires the Basic plan or higher + the new version of Markets ."