Badges
Badges call out what matters on product cards and product pages. Treble has four automatic badges (Sale, New, Sold out, Pre-order), three Custom badges you switch on with product tags, and a Metafield badge that shows a text you write per product. Their rules, labels and colors are set once in Theme settings > Badges.

How to set it up
Step 1: Set up the badges
- Open Theme settings > Badges.
- Choose the Position on product cards (1): any corner of the image. Badges at the bottom of the image fade while the quick add button shows.
- Choose a Shape (2): same as the buttons, pill, rounded or square.
- In each group, turn the badge on or off, change its Label (leave it blank for the default text) and its colors. Colors left blank follow the color scheme.

Step 2: Sale, New, Sold out and Pre-order
- Sale shows when the price is lower than the compare-at price. Badge text shows "Sale", the percentage saved or the amount saved.
-
New shows on products tagged
new, or on products published within the number of days you set (Mark as new by). - Sold out shows when no variant can be bought; Pre-order when the variant sells as a pre-order (Theme settings > Pre-orders).
- Only one of Sold out, Pre-order and Sale shows at a time, in that order.
Step 3: Add your own badges
- Under Custom badge 1, type a Product tag, for example
bestseller, and a Label (blank shows the tag). Letter case doesn't matter. - Pick where it sits on product cards: On image (in one of the image corners), Above product title or Inline with product title, aligned left or right.
- For a different text per product, create a single line text product metafield, enter its key in Custom badge metafield (for example
theme.label), and pick its colors.
Step 4: Show badges on the product page
- Open a product template, and in Product details click Badges (or Add block > Badges).
- Turn off the badges this block should not show, and set the Alignment, with its own value on mobile.
Settings reference
Badges
| Position on product cards | Options: Top left, Top right, Bottom left, Bottom right. |
|---|---|
| Shape | Options: Same as buttons, Pill, Rounded, Square. |
| Sale | |
| Show sale badge | Turns this on or off. |
| Badge text | Options: Sale, Percentage, Amount saved. |
| Label | Leave blank for the default text. |
| Text color | |
| Background color | |
| New | |
| Show "New" badge | For products tagged "new", or published within the days set below. |
| Mark as new by | Options: Tag "new", Days since published. |
| New for | Slider. |
| Label | Leave blank for the default text. |
| Text color | |
| Background color | |
| Sold out | |
| Show sold out badge | Turns this on or off. |
| Text color | |
| Background color | |
| Pre-order | |
| Show pre-order badge | For variants sold as pre-orders (Theme settings > Pre-orders). |
| Text color | |
| Background color | |
| Custom badge 1 | |
| Product tag | Products with this tag show the badge. Letter case doesn't matter. Leave blank to turn off. |
| Label | Leave blank to show the tag. |
| Text color | |
| Background color | |
| Product card placement | Product pages and quick view show it in the Badges block. Options: On image, Above product title, Inline with product title. |
| Image corner | Options: Top left, Top right, Bottom left, Bottom right. |
| Alignment | Options: Left, Right. |
| Custom badge 2 | |
| Product tag | Products with this tag show the badge. Letter case doesn't matter. Leave blank to turn off. |
| Label | Leave blank to show the tag. |
| Text color | |
| Background color | |
| Product card placement | Product pages and quick view show it in the Badges block. Options: On image, Above product title, Inline with product title. |
| Image corner | Options: Top left, Top right, Bottom left, Bottom right. |
| Alignment | Options: Left, Right. |
| Custom badge 3 | |
| Product tag | Products with this tag show the badge. Letter case doesn't matter. Leave blank to turn off. |
| Label | Leave blank to show the tag. |
| Text color | |
| Background color | |
| Product card placement | Product pages and quick view show it in the Badges block. Options: On image, Above product title, Inline with product title. |
| Image corner | Options: Top left, Top right, Bottom left, Bottom right. |
| Alignment | Options: Left, Right. |
| Metafield badge | |
| Custom badge metafield | Namespace and key of a product text metafield, for example theme.label. Its text shows as a badge on product cards and the product page. Leave blank to turn off. |
| Custom badge colors | Options: Same as the New badge, Same as the Sale badge, Color scheme. |
| Custom badge color scheme | Uses the scheme's background and text colors. |
Badges
| Sale | Turns this on or off. |
|---|---|
| New | Turns this on or off. |
| Sold out | Turns this on or off. |
| Pre-order | Turns this on or off. |
| Custom badge 1 | Turns this on or off. |
| Custom badge 2 | Turns this on or off. |
| Custom badge 3 | Turns this on or off. |
| Metafield badge | Turns this on or off. |
| Alignment | Options: Left, Center, Right. |
| Alignment (mobile) | Options: Same as desktop, Left, Center, Right. |
How it works
- On product pages and in quick view, Sale, Sold out and Pre-order follow the selected variant.
- Badges also show on mega menu product cards.
- Pick custom colors with strong contrast between text and background, so badges stay readable.
Troubleshooting
A custom badge doesn't show.
Check the tag on the product in Shopify admin, and that the badge isn't turned off in the Badges block on the product page.
The New badge shows on old products.
With Mark as new by set to the tag, remove the new tag; with days, lower New for.