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

# Badges

Manages product badge appearance and behavior across collections and product grids. Use it to highlight special product states like **Sale**, **Sold out**, **New**, **Custom tags**, or **Pre-Order**.

<figure><img src="https://2636770384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsD7BEEDU3B7WiEJlN0F7%2Fuploads%2FNW3bI4r75bpvGeb9auxv%2Fbadges.gif?alt=media&amp;token=ad397357-f177-4ee9-b7d2-0d3c8aff8b28" alt="badges settings showcase in theme settings"><figcaption></figcaption></figure>

**Badge text size**:  Automatically scales based on your theme’s base typography size: `Extra small`, `Small`, `Medium`, `Large`, or `Extra large`.

**Alignment**: Controls where badges appear on product cards: `Top left`, `Top center`, `Top right`, `Bottom left`, `Bottom`.

> Tip: Avoid bottom alignment when Quick Add is enabled to prevent overlap.

**Sale badge -** Highlight discounted products and display savings visually.

* **Show sale badge**: Toggles the sale badge visibility.&#x20;
* **Show saving**s: Displays discount value.
* **Saving type**: `Percentage` or `Money`
* **Background / Text colors:** Customize sale badge colors to fit your theme.

**Custom badge -** Add unique product tags to showcase special messages like 'Pre-order' or  'Best Seller'. To activate, add the tag **`_badge_with_custom_text`** to a product.

* **Show custom badge**: Enables custom tag badges.
* **Background / Text colors**: Define badge colors for visual distinction.

**Sold out badge -** Automatically marks unavailable products.

* **Show sold out badge**: Displays when a product is out of stock.&#x20;
* **Background / Text colors**: Customize the appearance to match your theme.

**New badge** - Highlight recently added products automatically.

* **Show automatic new badge**: Enables auto 'New' label.
* **Background / Text colors**: Set custom badge colors.
* **Date limit**: Determines how many days after creation a product shows as new.&#x20;

**Preorder** - Used for products available for early purchase.\
To enable, add the tag **`_preorder`** to the product.

* **Show pre-order badg**e: Displays pre-order label.
* **Background / Text colors**: Set theme-appropriate colors.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://broadcast.presidiocreative.com/theme-settings/theme-settings/badges.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.