Leaderboards

Create time-bound or evergreen competitions and rank members against each other based on the points they earn.

What is the Leaderboards module?

The Leaderboards module creates ranked competitions based on members’ earned points. It adds a social, competitive element to your loyalty program.

Create and manage leaderboards from Loyalty Console → Users → Leaderboards. Configure the time window, recurrence, audience, and displayed positions. Recurring leaderboards roll over automatically.

---

How leaderboards work

Ranking

Members are ranked by earned points within the leaderboard’s time window. Points from neutralised or refunded events are excluded, so rankings reflect genuine earning activity.

Rankings refresh hourly, rather than in real time. The leaderboard records its last update time.

Tied scores receive the same rank using dense ranking. For example, 1, 2, 2, 3.

Time windows

Every leaderboard uses one of three time window types:

Type	Behaviour
Lifetime	No start or end date. Ranks members by all-time earned points. Always active.
Recurring	Resets automatically on a weekly, monthly, quarterly, or yearly cadence, anchored to calendar boundaries. Each completed period is frozen and a new period opens automatically. Runs indefinitely until deactivated.
Fixed period	Admin-defined start and end dates. The board freezes at the end date and remains viewable as a historical record.

Audience targeting

Leaderboards can optionally be restricted to a specific audience. Only members in the target audience are included in the ranking. If a member is removed from the audience mid-period, they are excluded on the next ranking refresh.

If no audience is set, all eligible members in your program are included.

Member display names

Members are ranked using their first name and last name initial (e.g. “Sarah T.”) to provide recognition without full identity exposure.

Participation

Members choose whether to take part. Members who opt out are excluded from every ranking.

Members control their own participation. You cannot opt them in or out.

---

Managing leaderboards

Create, edit, and view leaderboards from Loyalty Console → Users → Leaderboards.

The Leaderboard list view.

Leaderboard statuses

Leaderboards can have one of three statuses:

Status	Ranking	Visibility
Active	Rankings are computed and updated hourly	Visible to members
Inactive	Rankings are not computed	Not visible to members
Archived	Rankings are not computed	Not visible to members

Creating & editing a leaderboard

When creating or editing a leaderboard, you can configure the following:

1. Internal name: A system reference for the leaderboard, visible only to admins.

2. Display name & description: The user-facing name and description shown to members. Supports localisation for multi-language programs.

3. Status: Active or Inactive. (A leaderboard can also be set to archived when editing — see Leaderboard statuses.)

4. Ranking method: How members are ranked. Points based is currently the only option; other ranking methods may be available in future.

5. Time window type: Lifetime, recurring or fixed period.

6. Recurrence schedule: Shown when the time window is recurring — weekly, monthly, quarterly, or yearly.

7. Start & end dates: Shown when the time window is fixed period. Defines when the competition runs.

8. Audience: Optionally restrict the leaderboard to a specific audience segment.

9. Leaderboard size: The number of top participants displayed to members (default 10).

10. Display priority: Controls display ordering when multiple leaderboards are active. Higher-priority leaderboards appear first.

Lifetime

Recurring

Fixed Period

Leaderboards cannot be deleted. Set a leaderboard to Archived to remove it from your program.

Running multiple leaderboards

You can have multiple active leaderboards at the same time. Use the display priority field to control the order in which they’re presented to members — higher priority appears first.

Viewing historical periods

For recurring and fixed-period leaderboards, completed periods are frozen and preserved. You can review the final rankings for any historical period from the leaderboard detail screen in the console. Recurring periods roll over automatically — no admin intervention is required.

A weekly recurring leaderboard with historical periods.

---

Leaderboard use case examples

Use leaderboards for campaigns, tier engagement, or long-term recognition.

Monthly Top Earners

Create a recurring monthly leaderboard for all members. Rankings reset each month, giving everyone a fresh start.

VIP Race

Create a recurring leaderboard for your VIP audience. This creates exclusivity and motivates members to reach VIP status.

Summer Challenge

Create a fixed-period leaderboard from June through August. The final rankings remain available after the campaign ends.

All-Time Champions

Create a lifetime leaderboard using all-time earned points. Recognise your most loyal members and set a long-term goal for others.

---

FAQs

Can I run multiple leaderboards at the same time?

Yes. You can have multiple active leaderboards simultaneously. Use the display priority field to control which leaderboard appears first.

Are rankings updated in real time?

No. Rankings are recomputed hourly, and the last update time is recorded so you can see when the data was last refreshed.

Can members participate without showing their name?

In the current version, members are ranked as first name and last initial (e.g. “Sarah T.”). Members who don’t want to be visible can opt out entirely, which removes them from all rankings. There is no anonymous participation mode at this time.

What happens when a recurring leaderboard period ends?

The platform automatically freezes the completed period’s rankings and opens a new period. No admin intervention is required. Historical periods and their final rankings are preserved and viewable in the console.

Can I award prizes based on leaderboard position?

Automated prize or reward distribution based on leaderboard rank is not currently supported. You can manually review final rankings and issue rewards using other platform tools.

Does the leaderboard work in the Loyalty Mobile App?

Leaderboards are not currently supported by our Loyalty Mobile App product. Speak to your account manager for more information.