Guides
Product Badges
How Sale, New, Low Stock, and Bestseller badges are triggered and displayed across product cards and product pages.
Product Badges
Product badges are small labels shown near product titles on product cards and product detail surfaces. They help call out products that are on sale, recently added, low in stock, or part of your best seller collection.
Where Badges Appear
Badges can appear in these places:
- Product pages
- Featured Product sections
- Product cards in collection, featured collection, product grid, recommendation, recently viewed, cart upsell, and search surfaces
Some product-card sections include a Show badges setting. Turning this off hides badges for that section only. Product page and Featured Product badges are shown automatically when a badge condition applies.
Badge Types
| Badge | What Triggers It | Where It Appears |
|---|---|---|
| Sale | The selected variant has a compare-at price higher than its price. | Product pages and product cards |
| Low stock | The selected variant is inventory-managed, does not allow overselling, has stock above 0, and has stock at or below the low stock threshold. | Product pages and Featured Product only |
| New | The product has a new tag, or the product was published in the last 5 days. | Product pages and product cards |
| Bestseller | The product belongs to a collection with the handle best-sellers. | Product pages and product cards |
Best Seller Setup
The Bestseller badge is collection-based, not product-tag based. To show it:
- In Shopify Admin, create or open a collection for your best sellers.
- Set the collection handle to
best-sellers. - Add the products that should show the Bestseller badge to that collection.
- Make sure badges are enabled on any product-card section where you want the badge to appear.
A product tag such as best seller, bestseller, or best-seller does not trigger the Bestseller badge.
Low Stock Setup
The Low stock badge uses the global theme setting Low stock threshold in Theme Settings.
A variant shows the Low stock badge when all of these are true:
- Shopify tracks inventory for the variant.
- The variant inventory policy is set to stop selling when out of stock.
- The variant inventory quantity is greater than 0.
- The variant inventory quantity is at or below the configured threshold.
For example, if the threshold is 5, a variant with 5, 4, 3, 2, or 1 item available can show the badge. A variant with 0 items does not show the Low stock badge.
Badge Priority
A product can qualify for more than one badge at the same time, but only two badges are shown visually. When more than two badges apply, the theme uses this priority order:
- Sale
- Low stock
- New
- Bestseller
For example, if a product is on sale, low in stock, new, and in the best-sellers collection, the visible badges are Sale and Low stock.
Notes
- Badge text is translated through the theme language files.
- Low stock updates when a shopper changes variants on the product page.
- Sale status also updates when a shopper changes variants on the product page.
- The Bestseller and New badges are product-level badges, so they do not change when variants change.