Guides
Product badges
How Propel's Sale, Low stock, New and Bestseller badges are triggered, where they appear, and how to style them.
Product badges are small labels that call out products that are on sale, low in stock, new, or best sellers. Propel adds them automatically when a product meets the conditions below. Apart from the optional new tag, there is nothing to set on each product.
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 tracks inventory, can't be oversold, and has at least 1 and no more than the low stock threshold left. | Product pages and Featured product only |
| New | The product has the tag new, or it was published within the last 5 days. | Product pages and product cards |
| Bestseller | The product is in a collection with the handle best-sellers. | Product pages and product cards |
Where badges appear
Product pages and Featured product
On product pages, badges show only where the Badges block is placed:
- Go to Online Store > Themes > Customize.
- Open a product template and select Main product.
- Make sure the Badges block is added, and drag it to where you want the badges.
The Featured product section works the same way: add its Badges block to show badges there. Without a Badges block, no badges show in that section.
Product cards
Product cards show Sale, New and Bestseller badges. These sections have a Show badges setting, on by default, that turns card badges off for that section only:
Cards in other places, such as search results and the Cart upsell, always show badges when they apply.
Mega menu feature card
In the Header, each Mega menu panel block can show a feature product card. Its Feature badge label setting adds your own label to that card. The label takes one of the card's two badge slots, so at most one automatic badge shows beside it.
Badge priority
A product can qualify for several badges, but no more than two show at once. When more than two apply, Propel uses this order:
- Sale
- Low stock
- New
- Bestseller
For example, a product that is on sale, low in stock, new and in the best-sellers collection shows Sale and Low stock.
Low stock threshold
Set the threshold in Online Store > Themes > Customize > Theme settings > Product display > Low stock threshold. The default is 5.
With a threshold of 5, a variant with 5, 4, 3, 2 or 1 left shows the Low stock badge. A variant with 0 left does not. Variants set to continue selling when out of stock never show it.
Best seller setup
The Bestseller badge comes from a collection, not a product tag.
- In Shopify admin, go to Products > Collections.
- Create or open your best sellers collection.
- Set its handle to
best-sellers. - Add the products that should show the badge.
Tags such as bestseller or best-seller do not trigger the badge.
Sale badge style
Choose how the Sale badge looks in Theme settings > Product display > Sale badge style:
- Outline (default): Accent border and text.
- Filled: Accent background with the Text on accent color.
The style applies on product pages and product cards. If you choose Filled, check that Accent and Text on accent have enough contrast. See Colors: palette and color roles.
Notes
- Sale and Low stock update when a shopper changes variants on the product page.
- New and Bestseller apply to the whole product, so they don't change with the variant.
- Badge text is part of the theme's storefront text and is translated in every included language.