Skip to main content

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 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):

Set tier levels

Nudj ships with 4 default tiers (Bronze, Silver, Gold, Platinum). Add or rename as needed.

Set XP thresholds

Each tier has a minimum XP to enter. Members auto-promote when their XP crosses the threshold.

Configure per-tier perks

  • Entry reward allocation multipliers (#2243) — Gold members get 2x entries on the same challenge.
  • Tier-exclusive challenges.
  • Custom theme overrides (optional).

Save

Tier updates propagate instantly — members recalculate based on their current XP.

​
Per-tier entry rewards

The entry reward per loyalty tier (#2243) feature lets each tier get a different allocation from the same reward: 
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.

​
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

Escalating rewards

Better rewards per tier — makes climbing worth it.

Tier-exclusive content

Gate challenges with achievement-as-action and a “you must be Gold or higher” achievement.

Per-tier leaderboards

Run separate leaderboards per tier so Bronze competes with Bronze, Gold with Gold.

Tier-based support

Route support queries from Platinum members to a fast lane.

​
Best practices

Keep the number of tiers small — 3 to 5 is the sweet spot. More than 5 and tier progression gets lost in the noise.
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.