# How to add product badges

<figure><img src="/files/4lv4yR4rGRKC4O0tiWDy" alt="A series of product grid items, some of the items have badges such as &#x27;Bestseller&#x27; and &#x27;SPF&#x27; overlaying the product image in the top left corner."><figcaption><p>Custom product badges on the Primavera theme's Gloss demo. Here you can see <strong>Bestseller</strong> and <strong>SPF</strong> as custom badges.</p></figcaption></figure>

### Step 1: Enable custom badges in the global settings

* In the customizer, navigate to global Theme Settings > Product Card
* Enable the **Show custom badges** option

### Step 2: Create a custom metafield for the badge content

* Navigate to **Settings > Custom data > Products**
* Select **Add definition**
* Enter a title, e.g. **Badges**
* Click the 'custom.badges' text to unlock the namespace and key field. Under namespace and key, enter `theme.badges`
* Under Select type, choose Single line text&#x20;
* Select List of values
* *Optional*: You can choose to limit to preset choices, e.g. **New**, **Editor's Choice**, etc. This is useful if you want to prevent typos or keep consistent badges.
* When ready, hit **Save**
* Now, for any product you want to add badge(s) to, navigate to the product in the Admin, scroll down the page and add each badge as a new item:

<figure><img src="/files/h604FSgCCbOTcjhfSRy2" alt="Screenshot of the Shopify admin showing a form field for Badges, a single line text form field. The field value is &#x27;New&#x27;."><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ultramarinastudios.com/guides/how-to-add-product-badges.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.