> For the complete documentation index, see [llms.txt](https://support.storefront.co.za/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.storefront.co.za/features/catalogue/badges.md).

# Badges

Badges are small graphics added over a product's image to draw attention to something about it, such as a sale, a new arrival or a low stock warning. The badge appears wherever that product image is shown on your storefront.

Badges work best used sparingly. If every product carries one, none of them stand out, and they start to obscure the product photography.

### Adding a Badge

A badge is made up of the text it displays, where it sits on the product image, and the styles that control how it looks.

1. Click on **Catalogue > Badges**.
2. Click the **Create** button.
3. Choose a badge type — **Text Badge** (a text label) or **Image Badge** (a graphic you upload) — and click **Select**.
4. Enter the text you want to display in the **Text** field.
5. Choose where the badge should sit on the product image from the **Badge Position** dropdown (Top Left, Top Right, Bottom Left or Bottom Right).
6. Under **Styles**, click the swatch next to **color** to open the colour picker and choose the text colour, either by picking a preset swatch or entering a hex code.
7. Click the swatch next to **background** and choose the badge's background colour the same way.
8. Click **Save Changes**.
9. Assign the badge to a product, then check it on your storefront.

{% hint style="info" %}
If you would rather not set colours on every badge, defaults for colour, background, height, width and line height can be set once under Store Settings > Catalogue & Products > Badge default styles.
{% endhint %}

{% hint style="warning" %}
Badges work best used sparingly. If every product carries one, none of them stand out, and they start to obscure the product photography.
{% endhint %}