Skip to main content
Gamification adds a points ledger on top of badges. Members earn points for things they already do (buying, attending, referring, posting), those points feed a leaderboard, and badges with a points threshold act as tiers members climb. Built for organizations with a large, quiet membership where the goal is to surface and reward the people who actually turn up. Replaces the engagement spreadsheet and the manual “member of the month” shortlist. It is not a loyalty scheme with redeemable rewards: Orgo counts points, it does not spend them. Everything on this page sits behind one switch: Enable tiers/levels by points. Without it, badges still work but no points are recorded anywhere.

​
Turning it on

Settings → Modules → Gamification & Courses → Gamification, which needs ADMIN_TENANT. Changes save as you flip each switch. Gamification module settings showing the Enable Gamification Module switch and the badge categories, hours tracking, badge per event, and tiers feature switches

​
How members earn points

Turning tiers on reveals Point Rules and Engagement Points. Set a rule to 0 and that source stops awarding. Every rule ships with a fallback that applies only until you save the panel for the first time: 1 point per currency unit, 100 for an event, 100 for a referral, 50 for a discussion, 10 for a comment, 2 for a reaction. After the first save, the numbers on screen are the numbers in force. Event points are recorded once per attendance record, and they are taken back if the attendance is deleted or the RSVP moves away from attending. Points are for members only: contacts never accumulate them.

​
Tiers

A tier is a badge with Points required set on it. On a member’s profile, the overview card is retitled Membership level and shows the member’s total points, their current tier, and every tier as a card marked Achieved or Locked against that total.
Tier cards on the profile light up from the points threshold alone, but the automatic promotion that actually writes the badge onto the member also needs an ordering number (level) on each tier badge. The settings screen does not expose that field today, so set it through the API (PATCH /badges/{id}) or award tier badges by hand. When automatic promotion does run, it grants the highest tier the member qualifies for and removes their lower tier badges, so a member holds one tier at a time.

​
The points ledger

Every point movement is a dated row: how many points, which activity type (purchase, event, engagement, referral, manual), a description, and a reference to the record that caused it. The member’s total is the sum of those rows. Open a member, go to the Badges tab, and the ledger sits below their badges and volunteering hours. HR_TENANT can correct the point value on a row or delete a row outright; the activity type, description, and reference are fixed. There is no button to add points by hand, so a correction means editing or removing an existing row.

​
The leaderboard

Analytics (/stats) → Leaderboards → Points ranks the top 50 members by points, over the last 7 days, the last 30 days, or all time. It uses the same filters as the rest of the analytics page: member status, user type, and local center. The card only appears when both the module and tiers are on. Who can open the Leaderboards tab at all is set by the Leaderboards permission under Analytics on the Permissions setup page (Settings → Modules → Users & Profiles → Security & Permissions). It defaults to every member, so raise it if rankings should stay with staff. The same tab carries leaderboards that do not depend on gamification at all: events attended, posts written, reactions received, and referrers. Those stay visible whether or not points are switched on.

​
Common questions

Check that Enable tiers/levels by points is on, then check the rules themselves: a rule left at 0 awards nothing. Points also start from the moment the switch goes on, so nothing is backfilled for past activity.
No. The ledger is permanent, and the 7 and 30 day buttons only narrow the leaderboard window, not the member’s total.
Recording stops and the leaderboard card disappears, but nothing already earned is deleted. Turn it back on and the old totals are still there.
Not from the interface: there is no add-points button. Award a badge by hand instead, or adjust an existing ledger row.
Purchase points are awarded when the payment is recorded and are not reversed by a refund. Edit the ledger row down as HR_TENANT.