> For the complete documentation index, see [llms.txt](https://modutheme.gitbook.io/helix/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://modutheme.gitbook.io/helix/how-to-guides/how-to-set-up-a-custom-badge.md).

# How to set up a custom badge

A custom badge shows a per-product label, such as "Limited Edition" or "Handmade". The text comes from a product metafield, so you set it on each product individually.

![Custom badge displayed on a product card](/files/zBOAOsu1ZIfcVou9DhZK)

***

**Step 1 — Turn it on in Theme Settings:**

1. In the theme editor, open [**Theme Settings → Badges**](/helix/theme-settings/badges.md#custom-badge) and turn on **Custom badge**.
2. Choose the badge's **background** and **text** colours — they apply to every custom badge — then save.

**Step 2 — Create the metafield in Shopify admin:**

1. Go to **Settings → Metafields and metaobjects → Products** and click **Add definition**.
2. Configure:
   * **Name** — `Badge`
   * **Namespace and key** — `modutheme.badge`
   * **Type** — Single-line text, one value
3. Click **Save**.

![Creating the Badge metafield definition in Shopify admin](/files/8aTaJzHXu22xFwDE5WZK)

**Step 3 — Apply to products:**

1. Open any product in Shopify admin.
2. Scroll to **Metafields → Badge** and enter the badge text (e.g., `Limited Edition`).
3. Save the product.

![Adding a custom badge metafield value to a product in Shopify admin](/files/4sz9ypgCEv2tdRZeAPBz)