For the complete documentation index, see llms.txt. This page is also available as Markdown.

Badges

Manages product badge appearance and behavior across product cards and product pages. Use it to highlight special product states like Sale, Sold out, collection labels (New, Best Seller), or Custom tags.

Badges setting panel

Sale Badge

Appears automatically on any product with a compare-at price. The choice is how the discount reads — each format lands differently:

Text sale badge

Shows a plain "Sale" label.

Percentage sale badge

Shows the discount in words, e.g. "20% off".

Percentage only sale badge

Shows a compact discount, e.g. "−20%".

Save amount sale badge

Shows the money saved, e.g. "Save $10".

Badge colors are configured under Colors → Global Accent Colors.


Collection Badges

Surface editorial labels — "New Arrival", "Best Seller", "Exclusive" — across your catalog without editing products. Assign a badge to a collection and every product in it shows the badge.

Collection badges — three badges with different labels and colors on product cards

Run up to 3 at once, each with its own label, background, and text color — e.g. "New" for fresh arrivals, "Sale" for a promo collection, and "Staff Pick" for curated products, all together.

If a product is in multiple badged collections, the first configured badge wins. Order your three badges by commercial importance.


Custom Badge

For products that don't fit a collection rule — "Limited Edition", "Award Winner", "Handmade", or any one-off label. Its text comes from a product metafield, giving per-product precision with no collection to manage.

Custom badge displayed on a product card

To add a custom badge to a product, see How to set up a custom badge.


headset

Need help?

Whether you have a question, run into an issue, or just need some guidance, our support team is here to help.

Chat with us Submit a ticket

Last updated