> For the complete documentation index, see [llms.txt](https://help.byinspiredlabs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.byinspiredlabs.com/theme-settings/badges.md).

# Badges

Theme settings - Badges

Badges are small labels on product cards that share key information at a glance, such as a sale or a sold-out product. Poetic has three badge types:

* **Sale badge:** Shows on products that are on sale.
* **Sold out badge:** Shows on products where every variant is sold out.
* **Custom badge:** Your own label, such as "New arrival" or "Limited edition", added with a product tag.

<figure><img src="https://441504973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0IRrXJZ4YweBmaaR6L8%2Fuploads%2FmgaHhdrHjXUxwl21hQLH%2FScreenshot%202025-07-18%20at%204.18.11%E2%80%AFPM.png?alt=media&amp;token=4de46d08-9480-4c6f-bd09-93802e099d2b" alt=""><figcaption></figcaption></figure>

### 1. Badge position

* **Badge position:** Where badges sit on product cards in the product grid and other product lists. Options:
  * **Top left:** On the top-left corner of the product image.
  * **Top right:** On the top-right corner of the product image.
  * **Below image:** Under the product image, with the card's details.

{% hint style="info" %}
**Note:** To show badges on the product page, add the [Badges](https://help.byinspiredlabs.com/product-page/product-information/badges.md) block or the [Custom badges](https://help.byinspiredlabs.com/product-page/product-information/custom-badges.md) block to the **Product information** section.
{% endhint %}

### 2. Sale badge

A product gets the Sale badge when its compare-at price is higher than its price and it's in stock.

* **Enable Sale badge:** Turn the Sale badge on or off.
* **Discount type:** What the badge says.
  * **Percentage:** The discount as a percentage, for example "SAVE 11%".
  * **Amount:** The discount in your store's currency, for example "SAVE $10.00".
  * **Text:** The words "On Sale".
* **Background:** The background color of the Sale badge.
* **Text:** The text color of the Sale badge.

{% hint style="info" %}
**Note:** If a product's variants have different discounts, **Percentage** and **Amount** show the biggest one, for example "SAVE UP TO 20%".
{% endhint %}

### 3. Sold out badge

* **Enable Sold out badge:** Turn the Sold out badge on or off.
* **Background:** The background color of the Sold out badge.
* **Text:** The text color of the Sold out badge.

### 4. Custom badge

* **Enable Custom badge:** Turn Custom badges on or off.
* **Background:** The background color of Custom badges.
* **Text:** The text color of Custom badges.

<details>

<summary><strong>How to create a custom badge</strong></summary>

* In your Shopify admin, open a product.
* In **Tags**, add a tag that starts with `_theme_` followed by your badge text. For example, `_theme_New arrival` shows a badge that says "New arrival".
* Underscores in the badge text become spaces, so `_theme_Limited_edition` shows "Limited edition".
* Click **Save**. The badge appears on the product's cards.

You can add more than one `_theme_` tag to a product. Each tag shows its own badge.

</details>

### 5. Which badges show together

* **Custom badges** always show first, alongside any other badge.
* **Sold out** and **Sale** never show together. If a product is sold out, it shows the Sold out badge only, even if it has a compare-at price.
* An in-stock product on sale shows the **Sale** badge.

**Examples:**

* Tagged `_theme_New arrival`, on sale and sold out: shows **New arrival** and **Sold out**.
* Tagged `_theme_New arrival`, on sale and in stock: shows **New arrival** and the **Sale** badge.
* On sale and sold out, no custom tag: shows **Sold out** only.
* On sale and in stock, no custom tag: shows the **Sale** badge only.

If you turn off a badge type, it simply doesn't show. Turning off the Sold out badge doesn't make the Sale badge appear on sold-out products.
