> ## 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.

# Tiers

> Loyalty tiers displayed in the widget

Tiers are loyalty levels — bronze / silver / gold style progression — where each tier unlocks different benefits. The widget surfaces your current tier, your progress toward the next one, and the perks associated with each.

## What a tier is

A tier is a rung on a ladder. Each tier typically has:

* A **threshold** — the metric (XP, points, purchases) required to reach the tier.
* A **set of perks** — benefits you get while you're at or above that tier (exclusive rewards, multipliers, early access).
* A **visual treatment** — icon, colour, label.

## Where it shows

* The widget home can show your current tier prominently.
* A tier-progress meter shows how close you are to the next tier.
* Tier details expand to show the perks at each tier.

## How progression works

As you earn XP (or the configured tier metric), you move up. Most communities use XP as the tier metric, but it's configurable. Tier downgrades — when they exist — are community-defined (for example, rolling annual XP windows).

## Configuration

Tier labels, thresholds, artwork, and perks are all configured per community. The widget renders whatever the community has set up.

## Related

<CardGroup cols={3}>
  <Card title="XP" icon="star" href="/user-guide/rewards/xp">
    The common tier metric.
  </Card>

  <Card title="Leaderboards" icon="ranking-star" href="/user-guide/leaderboards">
    Ranking against other members.
  </Card>

  <Card title="Widget overview" icon="window-restore" href="/user-guide/widget/overview">
    The bigger picture.
  </Card>
</CardGroup>