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

# Loyalty Tiers

> Tiered member progression: per-tier entry rewards, level config, tier management

Loyalty tiers bucket your members into levels (Bronze, Silver, Gold, Platinum, etc.) based on XP thresholds. Each tier can have its own perks — bigger entry-reward allocations, exclusive challenges, VIP support, custom theme overrides.

## Configuring tiers

**Gamification -> Loyalty Tiers** (#2198):

<Steps>
  <Step title="Set tier levels" icon="stairs">
    Nudj ships with 4 default tiers (Bronze, Silver, Gold, Platinum). Add or rename as needed.
  </Step>

  <Step title="Set XP thresholds" icon="bolt">
    Each tier has a minimum XP to enter. Members auto-promote when their XP crosses the threshold.
  </Step>

  <Step title="Configure per-tier perks" icon="gift">
    * Entry reward allocation multipliers (#2243) — Gold members get 2x entries on the same challenge.
    * Tier-exclusive challenges.
    * Custom theme overrides (optional).
  </Step>

  <Step title="Save" icon="save">
    Tier updates propagate instantly — members recalculate based on their current XP.
  </Step>
</Steps>

***

## Per-tier entry rewards

The **entry reward per loyalty tier** (#2243) feature lets each tier get a different allocation from the same reward:

```text theme={null}
Bronze: 1 entry per challenge completion
Silver: 2 entries
Gold: 3 entries
Platinum: 5 entries
```

Configure on the reward itself — attach multiple tier-scoped allocations. Tier ID fixes in #2243 ensure the right members get the right allocation.

***

## Level settings sidebar

The Level Settings page (#2242) consolidates XP thresholds, tier config, and bonus XP in one navigable sidebar. See [Points & XP](/admin-guide/gamification/xp-currency#level-settings).

***

## `levelConfig` included in responses

The member-facing API now returns `levelConfig` (#2147) so client apps can display tier progress bars without extra fetches.

***

## Tier-based strategies

<CardGroup cols={2}>
  <Card title="Escalating rewards" icon="gift">
    Better rewards per tier — makes climbing worth it.
  </Card>

  <Card title="Tier-exclusive content" icon="lock">
    Gate challenges with achievement-as-action and a "you must be Gold or higher" achievement.
  </Card>

  <Card title="Per-tier leaderboards" icon="trophy">
    Run separate leaderboards per tier so Bronze competes with Bronze, Gold with Gold.
  </Card>

  <Card title="Tier-based support" icon="headset">
    Route support queries from Platinum members to a fast lane.
  </Card>
</CardGroup>

***

## Best practices

<Tip>
  Keep the number of tiers small — **3 to 5 is the sweet spot**. More than 5 and tier progression gets lost in the noise.
</Tip>

<Tip>
  Design the **journey to tier 2** carefully. Most members should hit tier 2 within a week or two of joining — otherwise they never feel progression.
</Tip>