> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nudj.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# Badges

> Collectible emblems members earn once and keep: the 3-step badge wizard, award paths, and where badges display

Badges are collectible emblems members **earn once and keep**. There's nothing to redeem: the moment a badge is earned it lands in the member's collection, no codes or claim step involved.

## Creating a badge

Pick **Badge** in the [type picker](/admin-guide/rewards/reward-types). Because badges have nothing to supply, redeem, or fulfil, the wizard slims to **three steps**:

<Frame caption="The badge wizard: just Basic Information, Dates, and Advanced Settings.">
  <img src="https://mintcdn.com/nudj/3gjJsHCH5pH_dvLI/images/admin-guide/rewards/reward-creation-flow/badge-basic-info.png?fit=max&auto=format&n=3gjJsHCH5pH_dvLI&q=85&s=99d1624eb9f2ab40042f4b26f2ee079f" alt="Badge Basic Information step with the three-step sidebar" width="1440" height="1200" data-path="images/admin-guide/rewards/reward-creation-flow/badge-basic-info.png" />
</Frame>

<Steps>
  <Step title="Basic Information" icon="align-left">
    **Badge Image** (1:1 aspect ratio, ideally **512 x 512px**, cropped as a rounded square), plus the required title and description. PNG, JPG, GIF, or WebP. The **Featured** toggle is available; Spotlight isn't (badges award themselves, so there's nothing to spotlight for claiming).
  </Step>

  <Step title="Dates" icon="calendar">
    Just the **Earning Window** (start and end). No redeem-by deadline exists for badges.
  </Step>

  <Step title="Advanced Settings" icon="gear">
    Tags, accent color, template settings, metadata, and a dark-mode image variant.
  </Step>
</Steps>

<Frame caption="A badge's Dates step: the earning window only.">
  <img src="https://mintcdn.com/nudj/3gjJsHCH5pH_dvLI/images/admin-guide/rewards/reward-creation-flow/badge-dates.png?fit=max&auto=format&n=3gjJsHCH5pH_dvLI&q=85&s=96dce2215d40dcf00d8de2c15cff1e1f" alt="Badge Dates step showing only the Earning Window" width="1440" height="1200" data-path="images/admin-guide/rewards/reward-creation-flow/badge-dates.png" />
</Frame>

Supply is handled for you: badges are created with **unlimited supply, capped at one per member**. Rarity comes from how hard the badge is to earn, not from scarcity.

***

## How members earn a badge

* **Challenges** - attach the badge on a challenge's **Distribution** step.
* **Achievements** - the classic path: attach it on an achievement's **Rewards** step so it marks a milestone.
* **The shop** - badges can be listed in the [Reward Store](/admin-guide/rewards/shop-integration) for a points price (quantity is fixed at one).
* **Gifting** - hand one to specific members via [Gift Rewards](/admin-guide/rewards/reward-gifting).

However it's earned, the badge **auto-awards instantly** - the member sees it in their collection right away.

<Warning>
  **Live badges aren't secret.** Members can see every live badge as a locked, grayscale entry in their profile and wallet galleries before earning it. That's great for aspiration, but don't publish a surprise badge until you want it teased.
</Warning>

***

## Where badges display

* The member **profile page** (badges carousel) and the dedicated **Badges** page in the member app.
* The **widget profile drawer**: an earned/total count plus a badge grid, with unearned badges in grayscale.
* The **widget wallet** has a badges section and filter.
* Earning a badge from a challenge triggers a **badge unlock celebration** in the completion flow.

<Tip>
  Give badges clear, descriptive titles - the title doubles as the image's screen-reader text, and it's the label members see everywhere the badge appears.
</Tip>

***

## Badge analytics

A badge's **Stats** page works like any reward's: the Overview shows the claim funnel and a **Claims Timeline**, the **Users** tab lists every holder, and the config chips mark it as a **Digital Badge**. (A Fulfilment tab renders too, but badges never collect fulfilment details, so it stays empty.)

***

## Tiered badge design

Create a series of escalating badges to give members a ladder to climb:

| Tier   | Example                                 |
| ------ | --------------------------------------- |
| Bronze | "Newcomer" - first challenge completed  |
| Silver | "Regular" - ten challenges completed    |
| Gold   | "Champion" - fifty challenges completed |

Use [achievements as actions](/admin-guide/achievements/achievements-as-actions) to gate each tier behind the previous one.

***

## Next steps

<CardGroup cols={2}>
  <Card title="Reward types" icon="layer-group" href="/admin-guide/rewards/reward-types">
    Badges next to the other four types.
  </Card>

  <Card title="Achievements" icon="award" href="/admin-guide/achievements">
    The natural home for badge rewards.
  </Card>

  <Card title="The Reward Store" icon="bag-shopping" href="/admin-guide/rewards/shop-integration">
    Sell badges for points.
  </Card>

  <Card title="Reward analytics" icon="chart-line" href="/admin-guide/rewards/analytics">
    Track who's earned what.
  </Card>
</CardGroup>
