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.

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.

Show badges on product listings

---

Sale, sold out, and custom badges are enabled by default. You can toggle off badges and change their position on product cards.

Go to Theme settings > Product listing to find settings

Setting	Description
Show sale badge	Show sale badge on products with a 'compare at price' that's higher than the current price.
Show custom badges	Display discounts as a percentage or dollar value, or simply show a "Sale" text label.
Show sold out badge	Display 'Sold out' badge on products with zero inventory.

Sale badge

---

When you set sale prices in your Shopify admin, products will display a Sale badge with a "sale" or discount message.

Product discounts is a Shopify feature. Learn about Setting sale prices ↗ and Managing inventory ↗ on Shopify.

Go to Theme settings > Product badges to find settings

Setting	Description	Options
Color	Set the color of the badge background.
Sale badge format	Display discounts as a percentage or dollar value, or simply show a "Sale" text label.	Sale 20% off -20% Save 20% $5 off -$5 Save $5

Sold out badges

---

When products are out-of-stock, products will display a "Sold out" badge.

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

Product inventory is a Shopify feature. Learn about Managing inventory ↗ on Shopify.

Go to Theme settings > Product badges to find settings

Setting	Description
Background color	Set the color of the badge background.
Text color	Set the color of the "sale" and discount message.

Custom badges

---

Add up to 4 badges with custom messages and colors to display on specific products.

1

In theme settings > product badges, enter words in Badge tags want to display as a badge (e.g. "Limited edition").

Use the color selector to change the Badge color.

2

In your Shopify admin, add tags to your products using the exact same words.

Learn more about creating and using tags ↗ on Shopify. To use badge colors for multiple tags, enter the tags in a comma-separated list. For example: Best seller, New, Special.

Go to Theme settings > Product badges to find settings

Setting	Description
Badge tags	Enter the words to display as the product badge. For badges to appear, badge tags must match the product tags entered in your Shopify admin.
Color	Set the color of the custom badge.
Style	Choose to display badge labels in Uppercase text.

Translate custom badges

---

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

1

Add a new Metaobject with a field for each badge label

2

Add the default language text for each label as Entries

3

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 on the Custom badges definition

3. Click Add entry.

4. 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.

   
5. Under Handle, click Edit.

6. Enter custom_badges_translations as the entry's unique identifier.

   
7. 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.

---

Related links

Theme settings Collections template Product listings