# Badges

## What is the Badges module?

The Badges module adds the ability to award your loyalty users with achievement badges – a fun gamification tool designed to enhance your loyalty program and motivate user engagement. They can be used to recognise specific behaviours, milestones, or achievements within your program, making participation more rewarding.

They’re awarded to members as part of a [reactor’s reactions](https://kbase.whitelabel-loyalty.com/product/loyalty-engine/reactors/reactions), offering a sense of achievement without any monetary value when members report specific events. You can pair the award badge reaction with other reactions, like giving vouchers or adjusting points, to boost the impact.

{% hint style="info" %}
Modules are sold separately and **not included** in the Loyalty Engine core platform licence. For pricing and details, contact your account manager. 
{% endhint %}

***

## Managing badges

You can create, edit and view badges from the **Badge List** screen in the Loyalty Console.

<figure><img src="https://1999217057-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEFmrMvu6tg0ZiSX9SGEq%2Fuploads%2FJmW2PrXaZrrY2Or93ROu%2FScreenshot%2017.10.2024%2023.19%402x.png?alt=media&#x26;token=bc5abb92-3fa9-489f-a51c-d0e28661cb77" alt="" width="563"><figcaption><p>Badge list in Loyalty Console</p></figcaption></figure>

### Badge statuses <a href="#reactor-statuses" id="reactor-statuses"></a>

Badges can have one of three statuses:

<table><thead><tr><th width="137.72265625" valign="top">Status</th><th width="261.4453125" valign="top">Awardable</th><th valign="top">Visibility</th></tr></thead><tbody><tr><td valign="top"><mark style="color:green;"><strong>Active</strong></mark></td><td valign="top">Available to be awarded to users</td><td valign="top">Visible to users who have been awarded it previously</td></tr><tr><td valign="top"><mark style="color:yellow;"><strong>Inactive</strong></mark></td><td valign="top">Not awardable to users</td><td valign="top">Visible to users who have been awarded it previously</td></tr><tr><td valign="top"><mark style="color:red;"><strong>Archived</strong></mark></td><td valign="top">Not awardable to users</td><td valign="top">Not visible to users</td></tr></tbody></table>

***

## Creating & editing badges

From the Badge List screen, you can choose to create or edit a badge.

<figure><img src="https://1999217057-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEFmrMvu6tg0ZiSX9SGEq%2Fuploads%2FC4qRUgInC9uC1Scwg6UO%2FScreenshot%2017.10.2024%2023.21%202%402x.png?alt=media&#x26;token=36eac798-ce6b-4f9a-9361-f9c03c0a95a6" alt="" width="563"><figcaption><p>Creating / editing a badge</p></figcaption></figure>

### Badge details

Specify the following when you create or edit a badge:

1. **Status:** Determines whether reactors can award the badge and if members can see the badge as described above.
2. **Name & description:** A system reference for the badge, to explain the badge's purpose and any campaigns it may be a part of.
3. **Name, description & artwork (user-facing):** The metadata used when the badge is shown to users in the end-user interface.

Badges offer **localisation support**, meaning you can specify multiple languages for the user-facing badge metadata.

{% hint style="info" %}
As with all Loyalty Engine resources, **badges cannot be deleted**. To remove a badge from your program, set its status to archived. This prevents it being awarded in a reactor and hides it from members.
{% endhint %}

### Badge artwork guidelines

How badges are displayed to end-users is dictated by your user interface design, therefore there are no badge artwork guidelines for clients using their own interface.&#x20;

If you're using our [loyalty-microsite](https://kbase.whitelabel-loyalty.com/product/interfaces/white-label-interfaces/loyalty-microsite "mention") product, we recommend creating artwork that is 1:1 aspect ratio as a PNG or JPG, max \~200Kb with a 10-20% bleed area around the edges. This ensures quick load times and a consistent viewing experience.

{% hint style="info" %}
Badges are not currently supported by our [loyalty-mobile-app](https://kbase.whitelabel-loyalty.com/product/interfaces/white-label-interfaces/loyalty-mobile-app "mention") product. Speak to your account manager for more information.
{% endhint %}

***

## Awarding a badge

### Awarding a badge as part of a reactor

See [#award-badge](https://kbase.whitelabel-loyalty.com/product/loyalty-engine/reactors/reactions#award-badge "mention") in our [reactions](https://kbase.whitelabel-loyalty.com/product/loyalty-engine/reactors/reactions "mention") article.

### Giving a badge manually

You can give a badge to a member manually using the Loyalty Console.

1. Navigate to a member's profile.
2. Select the **Badges** tab and press '*Give Badge*'.
3. Select the badge you want to give the member from the dropdown, and optionally specify an internal comment to explain why you're awarding the badge. The member won't see this.
4. Press *Give Badge*.
   * [x] Done

<figure><img src="https://1999217057-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEFmrMvu6tg0ZiSX9SGEq%2Fuploads%2Fwv8g7dzZw8DDT0mXWy8k%2FScreenshot%2016.10.2024%2018.29.gif?alt=media&#x26;token=4a2323e6-5c43-440f-86fc-0f7e46f48367" alt="" width="563"><figcaption><p>Manually giving a badge to a member</p></figcaption></figure>

{% hint style="warning" %}
You cannot remove a badge from a user after it has been awarded or given.
{% endhint %}

### Viewing a member's awarded badges

You can view a member's awarded badges on their member profile in the Loyalty Console. Navigate to the member's profile and choose the **Badges** tab.

<figure><img src="https://1999217057-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEFmrMvu6tg0ZiSX9SGEq%2Fuploads%2FepdwEQtV5rf4vm5VX2YA%2FScreenshot%2017.10.2024%2023.22%402x.png?alt=media&#x26;token=2744c1a3-87d7-44f8-946d-ee047d30c282" alt="" width="563"><figcaption><p>Viewing a user's awarded badges in the Loyalty Console</p></figcaption></figure>

***

## Badge use case examples

Discover ways you can use badges in our platform with some context-specific examples below.

<details>

<summary>5-Star Favourite Badge</summary>

Award a 5-Star Favourite badge to users who submit a 5-star review on a product or service. This adds a fun reward for loyal customers who provide top ratings and can help encourage more positive reviews.

</details>

<details>

<summary>Gold User XXXX Year Badge</summary>

Give users a Gold User \[Year] badge when they reach gold tier status in any given year. For example, in 2024, users who reach the gold tier will receive a Gold User 2024 badge, and a new badge will be created for each calendar year.

</details>

<details>

<summary>Early Adopter Badge</summary>

Reward the first 100 users to join your loyalty program with an Early Adopter badge, along with a $10 voucher using a [reactor](https://kbase.whitelabel-loyalty.com/product/loyalty-engine/reactors) which is triggered on the `REGISTERED_ACCOUNT` event type. You can use the [tenant activation limit](https://kbase.whitelabel-loyalty.com/product/loyalty-engine/reactors/activation-limits#tenant-activation-limit) in the reactor to cap this, ensuring only the first 100 users receive the badge and voucher.

</details>

<details>

<summary>Top Spender Badge</summary>

Award a Top Spender badge to users who make at least 5 purchases of £100 or more. This can be done by creating a reactor [triggered by the `AUDIENCE_JOINED` event](https://kbase.whitelabel-loyalty.com/product/loyalty-engine/reactors/reactor-tutorials/create-advanced-or-multi-event-reactors-using-audiences), where users join an audience of those who have reported 5 or more TRANSACTION events, each with a total spend of at least £100.

</details>