Shopify quietly shipped one of its most useful admin features in years — and most merchants missed it. Starting with API version 2026-04, Shopify discount tags let you label, group, and filter every promotion in your store. The same tagging system you've used for products and customers for years finally works on discounts too.
If you're running more than a handful of promotions, you already know the pain. Your discounts page is a wall of codes with no grouping, no filtering, and no way to tell which ones belong to last month's email campaign versus your evergreen affiliate program. Discount tags fix that. Here's how to set them up and use them effectively.
What Discount Tags Actually Do
Discount tags are searchable labels you attach to any discount — codes, automatic discounts, or Shopify Functions-based discounts. Once tagged, you can filter your entire discounts list by tag, just like you filter products by vendor or type.
That means you can:
- Group all discounts from a specific campaign (e.g., "summer-2026" or "eid-sale")
- Label discounts by channel — "affiliate," "email," "influencer," "social"
- Mark discounts by status — "needs-review," "approved," "seasonal"
- Find every active promotion for a specific product launch in seconds
Tags don't change how discounts work for your customers. They're purely an organizational layer for you and your team inside the Shopify admin.
How to Add Shopify Discount Tags (Step by Step)
Adding tags works exactly like tagging products — if you've done that, you already know the workflow.
- Go to Discounts in your Shopify admin
- Open any existing discount (or create a new one)
- Scroll to the Tags field at the bottom of the discount details page
- Type a tag name and press Enter — you can add multiple tags per discount
- Save the discount
For bulk tagging, select multiple discounts from the discounts list, then use the bulk actions menu to apply tags to all selected discounts at once. This is the fastest way to retroactively organize discounts you've already created.
Tags are free-form text, so there's no setup or configuration required. Just start typing. Shopify will auto-suggest tags you've used before, which keeps your naming consistent. If you haven't created your discount codes yet, do that first — you can't tag discounts that don't exist.
Build a Tagging System That Scales
The biggest mistake merchants make with tags — on products, customers, or discounts — is tagging randomly without a system. You end up with "sale," "Sale," "SALE," and "on-sale" all meaning the same thing.
Pick a consistent format before you start. Here's a structure that works well for most stores:
-
Campaign tags:
campaign:summer-2026,campaign:eid-al-adha,campaign:black-friday -
Channel tags:
channel:email,channel:affiliate,channel:influencer,channel:social -
Type tags:
type:percentage,type:bogo,type:free-shipping,type:fixed-amount -
Status tags:
status:evergreen,status:seasonal,status:one-time
The prefix:value format prevents tag soup. When you filter by "campaign:" you see only campaign-related tags, not a mix of everything. It also makes bulk cleanup easier down the road.
Five Practical Ways to Use Discount Tags
1. Track Affiliate Performance Without Spreadsheets
Tag each affiliate's discount code with channel:affiliate and affiliate:name. When you need to review how a specific affiliate's codes are performing, filter by their tag instead of scrolling through hundreds of codes. Pair this with Shopify's built-in "Sales by discount" report for a complete picture.
2. Clean Up After Seasonal Sales
Tag every discount created for a seasonal campaign — campaign:ramadan-2026, for example. When the campaign ends, filter by that tag and deactivate or delete them all in one batch. No more orphaned codes sitting active in your store months after a promotion ended.
3. Separate Test Discounts From Live Ones
If you test discount configurations before launching them, tag test discounts with status:test. This prevents the "wait, is this one real or was I just testing?" confusion that happens when your discounts list grows past 50 entries.
4. Manage Multi-Region Promotions
Stores selling across multiple countries often run region-specific promotions. Tag discounts with region:mena, region:south-asia, or region:eu to see which promotions are active in which markets at a glance. COD-heavy regions often need different discount strategies than prepaid markets — tags make that split visible.
5. Audit Discount Stacking
Shopify lets customers combine up to 5 discount codes per order. If you're running multiple active promotions, tag combinable discounts with stacking:allowed and exclusive ones with stacking:exclusive. Before launching a new promotion, filter by stacking:allowed to see which other discounts a customer could stack it with. That one check tells you whether the combination still protects your margins.
Use Tags in the API for Automation
If you use Shopify's API directly or work with a developer, discount tags open up automation possibilities. The tags field is available on all discount mutations — discountCodeBasicCreate, discountCodeBasicUpdate, discountAutomaticBasicCreate, and their equivalents for other discount types.
A few things you can automate with tagged discounts:
-
Auto-expire seasonal discounts: Query all discounts tagged
campaign:summer-2026and deactivate them on a specific date -
Generate reports by channel: Pull all discounts tagged
channel:influencerand aggregate their usage stats - Sync with external tools: Use tags to map Shopify discounts to campaigns in your email platform or affiliate dashboard
The GraphQL Admin API supports filtering discounts by tag using the savedSearches and search query parameters, so you don't need to pull your entire discount list and filter client-side.
Common Mistakes to Avoid
Tags are simple, but a few patterns cause problems as your store grows:
Too many tags per discount. Stick to 3–5 tags maximum. If a discount needs 10 tags to categorize it, your tagging system is too granular. Simplify your categories.
Inconsistent naming. "Black Friday," "black-friday," "BF2026," and "blackfriday" are four different tags. Pick one format and document it. Lowercase with hyphens (black-friday-2026) is the easiest to keep consistent.
Tagging without purpose. Every tag should answer a question you actually ask. "Which discounts are from this campaign?" is useful. "Which discounts were created on a Tuesday?" is not. If nobody will ever filter by a tag, don't create it.
Never cleaning up. Tags accumulate. After a campaign ends and you've deactivated its discounts, consider removing the campaign-specific tags too. This keeps your tag autocomplete list clean and relevant.
Start With What You Have
You don't need to tag every discount in your store today. Start with your active discounts — the ones currently live and accepting orders. Open each one, add 2–3 tags using the prefix:value format, and save. That takes about 30 seconds per discount.
Once your active discounts are tagged, set a rule for yourself: every new discount gets tagged before you hit save. It takes five seconds during creation and saves you minutes of searching later. For stores running 20+ active promotions — especially COD stores juggling regional campaigns, affiliate codes, and seasonal sales — this small habit turns a chaotic discounts page into something you can actually manage.