Product badges

Product listings

Product badges are labels that appear on listed products that are on Sale, Sold out, or you can add Custom badges.

This guide shows how to set up and customize product badges. To enable badges to display on product cards, see the Product listing settings.

Why are custom badges not showing?

Make sure the badge tags match the exact spelling of the product tags in your Shopify admin. Also, check that the Show custom badges option is enabled in Theme settings > Product listing.

Sale and sold out badges

The Sale badge shows when a Compare at price is added in the Shopify admin. The Sold out badges show when a product's inventory is zero.

To disable sale or sold-out badges, click Theme settings and open the Product listing tab.

Shopify | Discounts and inventory are Shopify features. Learn about Setting sale prices ↗ and Managing inventory ↗ on Shopify.

STEPS

In your theme editor (Customize):

1. Click the Theme settings icon.

2. Click to open the Product badges tab.

   
3. Use the color selectors to change the Sale badge and Sold-out badge colors.

4. Select a Sale badge format with options for showing discounts by percentage or currency amount.

5. Click Save

Custom badges

Add up to 4 custom badges to display on products that have the badge tag added in the Shopify admin. For example, add a badge for "New arrivals" or "Limited editions".

STEPS

In your theme editor (Customize):

1. Click Theme settings and open the Product badges tab.

   
2. Enter the product tags in the Badge tag field.

   For badges to appear, badge tags must match the product tags entered in your Shopify admin.

   To use badge colors for multiple tags, enter the tags in a comma-separated list. For example: “Best seller, New, Special”.

3. Use the color selector to change the Background and Text colors.

4. In your Shopify admin, make sure you add the same Badge tag text in the Tags field for your products.

   Learn more about creating and using tags ↗ on Shopify.

5. Click Save.

Translate custom badges

You can use Metaobjects and Shopify's Translate & Adapt app to translate custom badge labels. There are three general steps:

• Add a new Metaobject with a field for each badge label

• Add the default language text for each label as Entries

• Use Shopify's Translate & Adapt app to translate the default label text.

STEPS

1. Add Metaobject with custom badge names

In the Shopify admin:

1. Go to Content > Metaobjects.

2. Click Add definition.

3. Enter Custom badges in the metaobject Name field.

   This name must match exactly.

4. Under Fields, click Add field.

5. Select Single line text.

6. Enter the badge label in the Name field.

   The name must exactly match the badge label.\

   
7. (Required) Uncheck Use this field as display name.

8. Click Add.

9. Repeat steps 4 to 8 for every badge label.

10. Click Save.

2. Add Entries for badge labels in default language

1. Go to Content > Metaobjects.

2. Click Add entry.

3. Enter the same name of each custom badge label.

   Enter the exact name to match the field label. This text will be the label text for the default language.\

   
4. Under Handle, click Edit.

5. Enter custom_badges_translations as the entry's unique identifier.\

   
6. Click Save.

3. Use Translate & Adapt to add translations

1. Go to Apps > Translate & Adapt.

   If you haven't already, go to Translate & Adapt on the app store and click Install.

2. Under Products, click Metaobjects.

3. Enter translations for each custom badge label.\

   
4. Click Save.

Settings reference

Sale color	Select the color of the text and border of the sale badge.
Sale badge format	Choose to display discounts by percentage or currency amount.
Sold-out color	Select the color of the text and background color of the sold-out badge.
Custom badge tags	Enter the badge tag text that matches Tags field under Product organization in the Shopify admin.
Custom badge color	Select the color of the text and border color of each custom badge.
Style	Choose to display badge labels in Uppercase text.

---

Related links

Theme settings Collections template Product listings