> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.optis.me/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Variant badges

1. [OPTIS Color Swatch](/swatch)
2. [Variant Badges](/swatch/variant-badges)

# Variant badges

| **Available on:** Product page, Collection page

**Variant badges** let you pin a small label directly on a swatch — things like *New*, *Hot*, *Limited*, or *Best seller* — so shoppers notice key variants at a glance without having to read through a product description.

***

## Manual, assigned by you

Every badge you create here is **manual**: you assign it to specific variant values yourself, and it shows on those values regardless of stock status.

|| Looking for a badge that appears automatically based on a store-wide rule — **Sold out**, **Low stock**, **New**, or **On sale** — with no manual assignment? See [Automatic badges](https://help.optis.me/en/article/automatic-badges-1xb2gsi/) under Global Settings.

***

## How it works

* A badge starts as a **preset** — design how it looks once, then assign it to as many values as you want.
* Each value can show **one badge at a time**.
* Updating a preset (text, color, position, shape) instantly updates everywhere it's assigned.
* Deleting a badge removes it from every value it was assigned to.
* Badges display on every variant display type: swatch, button, dropdown.

***

## Create a badge

1. Go to **Variant badges** → click **+ Create badge**

https://storage.crisp.chat/users/helpdesk/website/-/6/e/e/7/6ee7ace5febc8000/34f3d156-711a-4b0d-b328-b2e3d9_s56jdd.png

2. Fill in the badge details

https://storage.crisp.chat/users/helpdesk/website/-/d/0/e/f/d0ef03189e9ca000/41e8f955-6e02-48c5-bf96-a98c99_1woase2.png

| Field | Description |
| --- | --- |
| **Preset name** | An internal label for you to recognize this badge in the list. Shoppers don't see it. |
| **Badge text** | The text shoppers see on the swatch (up to 40 characters). Click the emoji icon to add an emoji. |
| **Text color** | Foreground/text color of the badge (hex code). |
| **Background** | Background color of the badge (hex code). |
| **Position** | Where on the swatch the badge appears: **Top left**, **Top right**, **Bottom left**, or **Bottom right**. |
| **Shape** | **Pill**, **Rectangle**, or **Corner ribbon**. |

The **Preview** panel on the right updates live as you type.

3. Click **Save**

You'll be taken to the badge's edit page, where the **Assign to swatches** section becomes active.

***

## Assign a badge to swatches

After saving, the **Assign to swatches** section appears below the badge form.

1. Pick the option from the dropdown

2. Check the values that should show this badge

The values already assigned to this badge are shown under **Currently assigned to**. Tick or untick individual values — changes save automatically.

https://storage.crisp.chat/users/helpdesk/website/-/f/e/2/e/fe2ea6f180b5c000/9fb117e7-6691-4041-8813-862237_1xnuyap.png

3. Click Save assignment to save the changes

|| **Note:** A value can only hold one badge at a time. If you assign a second badge to a value that already has one, the previous badge is replaced.