Leaderboards
The Leaderboards section lets the World Owner (or any role with the proper permission) create, edit, enable/disable, and delete the world’s leaderboards.
Leaderboards collect scores submitted by experiences and are visible to end users on the world’s landing page.
List controls
| UI element | Purpose |
|---|---|
| Search bar | Filter leaderboards by name. |
| Create Leaderboard | Open the creation form. |
| Enable/Disable | Show/hide the leaderboard on the landing page (does not delete data). |
Edit  | Modify the leaderboard fields. |
Delete  | Permanently delete the leaderboard and its scores. |
Create / Edit a Leaderboard
Fill the form with:
| Field | Description | Required |
|---|---|---|
| Name | Public label shown to users. | ✔ |
| Logic key | Unique identifier used by SDK / Creator Kit to write scores to this leaderboard. | ✔ |
| Data type | Score format (e.g., Integer, Decimal, Time [HH:mm:ss]). | ✔ |
| Display order | How the table is sorted: Ascending (lower is better) or Descending (higher is better). | ✔ |
| Unit of Measure | Optional label appended to the score when displayed in the app (e.g., pt, s, min, %). It does not affect storage or sorting. | |
| Enable | Toggle public visibility on/off. |
Important — data key disclaimer
Scores are stored under the Logic key they were written with.
- Changing the Logic key does not migrate historical data; existing entries remain under the old key.
- If your experience starts using a new key, it will write to a new/empty leaderboard.
- Renaming the Name or the Unit of Measure is safe (neither affects data).
- To merge/migrate scores between keys contact support.
How scores are submitted
Experiences send results via Creator Kit nodes or SDK API, referencing the leaderboard’s Logic key configured in Back Office.
What users see (Reflectis APP)
On the world landing page, users can open the Leaderboard view:
- If multiple leaderboards exist, users can switch between them.
- The ranking table is shown using the selected Display order.
- The current user’s position is highlighted, even when not in the Top 10.
- When configured, the Unit of Measure appears next to each score (e.g.,
1200 pt,01:23:45,87 %).
Notes & permissions
- Management is restricted to World Owners or roles with explicit permission.
- Disabling a leaderboard hides it from users but does not delete its data.
- Leaderboards are scoped to the world: each world can have one or more leaderboards independent of other worlds.