All docs

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

BadgeWhat Triggers ItWhere It Appears
SaleThe selected variant has a compare-at price higher than its price.Product pages and product cards
Low stockThe 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
NewThe product has a new tag, or the product was published in the last 5 days.Product pages and product cards
BestsellerThe 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:

  1. In Shopify Admin, create or open a collection for your best sellers.
  2. Set the collection handle to best-sellers.
  3. Add the products that should show the Bestseller badge to that collection.
  4. 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:

  1. Sale
  2. Low stock
  3. New
  4. 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.