Leaderboard
The Leaderboard ranks all participants in a challenge by total points earned within the selected period. It updates in real time as ledger entries are created.
Component placement
Add the Novigem Leaderboard component via Lightning App Builder. Recommended placements:
- Salesforce Home page: gives reps a quick rank check on login
- Dedicated app page: useful for teams who want a persistent view
See Lightning Components for step-by-step placement instructions.
Period filters
Users can filter the leaderboard by time period using the period selector:
| Period | What it shows |
|---|---|
| All-time | Total points since the challenge started |
| Weekly | Points earned in the current week, starting on the configured week start day |
| Monthly | Points earned in the current calendar month |
| Quarterly | Points earned in the current calendar quarter |
The period the leaderboard opens on is set org-wide by Default Timeframe under Novigem Admin > Settings > General. It ships as All-time. Users can still switch to any other period from the selector.
The Weekly period starts on the day set by Week Start Day in the same settings screen. The default is Monday, so a week runs Monday to Sunday unless you change it.
Recurring challenges reset the leaderboard at the start of each new period. See Challenge Types.
Ranking logic
The leaderboard uses dense ranking:
- Users with the same points share the same rank
- The next rank is incremented by 1, not by the number of tied users
- Example: two users tied at rank 2 means the next user is rank 3, not rank 4
Tie-breaking
When two users have the same score, the one who reached it first ranks higher. Novigem compares the earliest ledger entry each user has in the selected period, so the rep who got there first keeps the higher spot until someone passes them on points.
Streaks and personal bests
Streaks and personal bests are not shown on the leaderboard. They render in the Quick Stats component, which shows the current user’s daily and weekly point streaks alongside their rank. See Lightning Components.
Podium view
The top three participants are displayed in a podium layout (1st, 2nd, 3rd). All other participants appear in a ranked list below.
The current user is highlighted in the list regardless of their position.
Permissions
Users need read access to Challenge__c and Challenge_Progress__c for the leaderboard to display data. Assign the Novigem User permission set to grant access.