PDP Badges
Badges on the product page are controlled by the tags you set on the product in Shopify, with a few exceptions noted below that come from the product's own settings rather than a tag.
The product page has three badge areas.
Badges above the product title
Rounded badges with a colored background. A product shows a maximum of two — the two highest-ranked it qualifies for, from this order:
| Rank | Badge | What triggers it |
|---|---|---|
| 1 | Extra 30% off with code CHEERS | tag badge:eoy25clearance |
| 2 | Waived Rush Fee | the product's rush fee is set to zero |
| 3 | Whatever you type after the colon | tag custom-badge:your text here |
| 4 | Limited Time Offer | tag badge:limited time offer |
| 5 | Free Personalization | tag badge:free personalization |
| 6 | Personalization | personalization is enabled on the product |
| 7 | Discontinued | the product's Discontinuation Date has passed |
| 8 | New | tag New Arrival |
| 9 | Best Seller | tag Best Seller |
Ranks 2, 6 and 7 have no tag — they come from the product's own settings. They still take a
slot, and they outrank New Arrival and Best Seller.
A discontinued product tagged Best Seller shows Discontinued and nothing else, because
Discontinued is rank 7 and Best Seller is rank 9 with only one slot left. If a tag you added is
not showing, check whether two higher-ranked badges already qualify.
Writing your own badge text
custom-badge: is the one badge where you choose the wording. Everything after the colon
becomes the badge, so the tag custom-badge:Only 3 Left produces a badge reading
"Only 3 Left".
Keep it short — it sits on one line next to other badges. It is ignored on gift cards, swatches and swatch books.
Messages under the subtitle
Up to four things can appear here at once — they do not compete for a single slot:
| Message | When it shows |
|---|---|
| Out of Stock | the product is unavailable and tagged No Waitlist |
This style will be discontinued on <date> | the Discontinuation Date is in the future and the Discontinuation Level includes STYLE |
| Your first 10 swatches are free | swatch products, unless tagged badge:free swatch bundle or badge:BUNDLEUP |
| A promo badge | see the ranked list below |
Promo badge
Only the promo line is ranked. One shows — the highest-ranked the product qualifies for:
| Rank | Tag to add in Shopify | Badge |
|---|---|---|
| 1 | badge:lightningdeal | Extra 30% off with VIRALDEAL |
| 2 | BMSMWP | 20% off 4+ with TIEONEON |
| 3 | BMSMGR | 10% off 4+ with SUITELOOKS |
| 4 | badge:limited time color | Limited Time Color |
| 5 | badge:free swatch bundle | Your First Swatch Bundle is Free |
| 6 | badge:BUNDLEUP | First Bundle Free with Code BUNDLEUP |
Badge beside the price
One badge only, so there is nothing to rank: Final Sale, on final sale products.
The Discontinuation Date drives two different badges
The Discontinuation Date field on the product produces a different message depending on
whether the date has passed:
| Date | What shows | Where |
|---|---|---|
| In the future | "This style will be discontinued on <date>" | under the subtitle — and only if Discontinuation Level includes STYLE |
| In the past | "Discontinued" | above the title, at rank 7 |
So setting a future date shows the warning, and the same field flips to the Discontinued badge on its own once the date arrives. Nothing needs changing on the day.
Getting the tag right
Spelling and capitalization must match exactly. best seller will not work; it has to be
Best Seller. Copy the tags from the tables above rather than typing them.
The exception is custom-badge:, where only the prefix has to match — the text after the colon
is yours, capitalized however you write it.
Product page badges update as soon as the product saves in Shopify. Collection page badges take longer, so the same tag can show on the product page before it shows on a collection page.
What you can change yourself
| Change | Who |
|---|---|
| Which products show a badge | You — add or remove the tag in Shopify |
The wording of a custom-badge: badge | You — it is part of the tag |
| The wording of any other badge | Engineering |
| The color of a badge | Engineering |
| Which badges win when a product qualifies for more than two | Engineering |
| Adding a brand-new badge | Engineering |
The first two rows are tag changes. The rest need a code release, so raise a ticket with a few days' notice ahead of a launch.