> For the complete documentation index, see [llms.txt](https://docs.globo.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.globo.io/swatch/options/custom-badges.md).

# Custom badges

Add a small label or icon to individual option values to make them stand out.

Badges are small labels pinned to a swatch — "New", "20% off", a flame icon — to draw attention to a particular option value. They're set per value, on product pages.

## Turn badges on for an option

1. Go to **Options** and stay on the **Product page** tab.
2. On the option card, set **Show custom badges** to **On**.
3. Click **Manage badges**.

<figure><img src="https://3138853960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDsbeTbRNMPUo58YEXkMj%2Fuploads%2Fgit-blob-fca671bcd6c0ef2e6db8348b20e9952e4e7034cb%2Fimage%20(18).png?alt=media" alt=""><figcaption><p>An option card with Show custom badges set to On and the Manage badges button enabled</p></figcaption></figure>

## Add a badge to a value

The badge page lists every value of the option, with **Values found**, **Values with badges** and **No badge set** counts at the top.

For each value, pick a badge type and fill it in:

{% tabs %}
{% tab title="Text" %}

* **Badge text** — up to 12 characters.
* **Text color** and **Background color**.
  {% endtab %}

{% tab title="Icon" %}
Click **Add icon** and choose from the built-in set — heart, clock, star, check, fire, circle, smile, flash, diamond, eco, tag, bookmark, gift, filter, notification, done, discount — then pick its colour.
{% endtab %}

{% tab title="Image URL" %}
Paste a link to your own badge image. It must start with `http://` or `https://`.
{% endtab %}
{% endtabs %}

The **Preview** column shows the result, or **No badge** when nothing is set. Click **Save** when you're done.

<figure><img src="https://3138853960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDsbeTbRNMPUo58YEXkMj%2Fuploads%2Fgit-blob-1b1da94e02bd251fa73274b0eeb07ca366a06535%2Fimage%20(19).png?alt=media" alt=""><figcaption><p>The badge editor with the Text / Icon / Image URL tabs and a preview</p></figcaption></figure>

## Remove badges

* **Delete** on a row clears that value's badge.
* **Clear all** removes every badge on the option at once.

## Tips

Keep badge text short — the app's own guidance suggests **New**, **Hot**, **20% off**, **Limited**, **Best seller**. Badges work best when only one or two values carry them; badge everything and nothing stands out.

Badges are optional. Use them to highlight important option values, promote discounts, or create urgency.

## Related pages

* [Options overview](/swatch/options/overview.md)
* [Sale badge and in-stock message](/swatch/appearance/sale-badge-and-in-stock-message.md) — a different badge, driven automatically by the variant's price.