Badges
Sale, sold out, new, preorder, and 2 custom tag badges — with global colour and format settings.
Updated 2026-05-09
Theme settings → Badges.
Built-in badges
Dost renders badges on product cards, the product page, and quick view based on real product state plus tag matching.
| Badge | Triggers when… |
|---|---|
| Sale | compare_at_price > price on the variant |
| Sold out | Product not available |
| New | Published within the last N days (configurable, default 30) |
| Preorder | Product has the pre-order tag |
| Custom 1 | Product has the tag specified in Custom 1 tag |
| Custom 2 | Product has the tag specified in Custom 2 tag |
Each badge has its own background colour and text colour controls. They share the same border-radius (set via Theme settings → Style → Radius → Badge).
Sale badge format
Three formats:
- Percent off (e.g.
−20%) — auto-calculated - Amount off (e.g.
−$10) — auto-calculated - Custom text (e.g.
Sale) — static label
The Price block on the product page can independently override this format — see Price block.
"New" threshold
Theme settings → Badges → "New" badge max age (days). Default 30. Set to 0 to disable the New badge globally without unticking it on every section.
Excluding collections from "New"
Theme settings → Badges → Exclude collections from New badge (collection list picker). Useful for a "Sale" or "Archive" collection where you don't want NEW labels — even for recently re-published items.
Custom badges
Two slots, each with:
- Tag — the product tag that triggers the badge (case-insensitive)
- Label — what shows on the badge
- Colour
Common uses:
bestseller→ "Bestseller"eco-friendly→ "Eco"limited-edition→ "Limited"
Stacking rules
The card and PDP enforce a priority so badges don't pile up:
- Sold out wins over Sale, New, Preorder unless the product is also a Preorder (preorder badge wins to communicate availability intent).
- Sale and New are mutually exclusive — Sale wins if both apply.
- Custom 1 / 2 stack alongside the primary badge.
Tips
- The accent colour from Theme settings → Colors is used as the default sale-badge background. Override only when you want a non-accent sale colour.
- Keep custom badge labels under 10 characters — anything longer wraps and looks cluttered.