Badges, Sets & Prestige
The badge progression layer: progress bars, collectible sets with completion perks, prestige tiers, and managing custom badge types.
Badges are persistent recognitions on a member's profile. On top of the individual badges covered in Leaderboard & XP, Onsend runs a progression layer: members see progress toward badges they haven't earned yet, badges group into collectible sets that grant a perk when completed, and repeatable achievements stack into prestige tiers. Most of this is automatic. Your job as an admin is mainly to define any custom badges you want and let the rest run.
Progress
Members see how close they are to the next badge, not just the ones they've earned.
Sets & perks
Related badges form a set; completing the set grants a reward.
Prestige
Repeatable achievements stack into Bronze → Silver → Gold tiers of the same badge.
The progression layer (automatic)
These behaviours are built in and run on their own. There's nothing to configure. They're worth understanding so you know what your community is experiencing.
Progress bars
For badges that count toward a threshold (complete 50 quests, reach 10 referrals), members see a progress bar toward the next badge instead of just a locked icon. It turns a far-off badge into a visible goal.
Badge sets and set-completion perks
Related badges are grouped into a set (a collection). When a member earns every badge in a set, the set is marked complete and they receive a set-completion perk, a reward for finishing the collection rather than collecting piecemeal. Sets and their perks are part of the built-in progression system; members see their set progress on their profile.
Prestige tiers
Some achievements are repeatable, and instead of granting the same badge over and over they stack into prestige tiers: Bronze, then Silver, then Gold, of the same badge. A member's badge shows its current prestige level, so a long-running contributor's profile reflects how many times they've hit the mark. Prestige only ever moves up.
Members experience this on their profile
Progress, sets and prestige all surface on the member-facing profile and badge views; they're recognition mechanics for your community. They award XP and coins (where the coin economy is enabled) like any other reward, recomputed shortly after a member qualifies.
Built-in badges
Seven badges ship with every project and are granted automatically the moment a member qualifies. You don't configure these. They're listed in full under Leaderboard & XP → Badges (early supporter, quest completionist, referral master, veteran, journey finisher, squad founder, claim recipient).
Custom badges: what you control
Open Badges in the admin sidebar (requires the Admin role). This is where you define custom badge types for your project. Built-in badges are listed here too, read-only, and you can't edit or delete them.
Admin → Badges: built-in types, custom types, and the custom-badge quota
slot: badges.managementCreate a custom badge type
In the Create custom badge type form, set:
- Slug: lowercase, no spaces (e.g.
og_holder); 2–48 characters. - Display name: up to 80 characters (e.g.
OG Holder). - Description (optional): up to 280 characters.
- Tier:
STANDARD,RARE,EPICorLEGENDARY(used for display).
Admin → Badges → Create custom badge type
slot: badges.create-customGrant it to members
Custom badges are awarded manually from a member's detail page (open them under Users). Use them to recognise contributors, contest winners, or anyone your automated badges wouldn't catch.
Custom badge cap
Each project may define up to 20 custom badge types; Enterprise plans are uncapped. Built-in badges don't count toward the cap. The Badges page shows your current usage (e.g. 5 / 20). To add more once you're at the cap, delete an unused custom type first.
Revoking a badge is a soft action: the badge is tombstoned, history is kept, and it stops counting toward reputation.
Tips
- You configure custom types; the rest is automatic. Progress bars, sets, set-perks and prestige all run without setup; you don't wire them.
- Use custom badges for the human touch. Built-ins cover the obvious milestones; custom badges are for the recognitions only you know to give.
- Mind the cap. Twenty custom types is plenty for most projects, so retire old ones rather than letting the list sprawl.