Leaderboards rank teams by performance for a specific event. Each event has its own leaderboard configured separately with row count, which columns appear, and whether to filter to no-hint completions only. The board can be opened in a fullscreen mode for displaying on a venue screen.
Getting started
Navigate to Reporting and analytics > Events from the sidebar. You'll see one card per event. Click Leaderboard on the event you want to display, or Leaderboard settings to configure it first.
How it works
Leaderboards are per event. Each event has its own configuration that determines how many rows appear, which columns show, and whether the board only displays teams that finished without hints.
The two pages:
| Page | Purpose |
|---|---|
| Leaderboard settings | Configure number of rows, columns shown, no-hint filter, completion-rate threshold, and activation status |
| Leaderboard | The live ranked board, with a fullscreen toggle for venue screens |
Step-by-step guide
Configure a leaderboard
Open Reporting and analytics > Events, find the event you want, and click Leaderboard settings. The settings page opens with the heading Leaderboard settings for [event name]. Set the configuration:
| Field | Type | What it does |
|---|---|---|
| Number of rows to show | Number | How many top teams render on the board (e.g., 10, 20, 50) |
| Show number of players | Checkbox | Adds the player count column to each row |
| Show number of hints received | Checkbox | Adds the hints column to each row |
| Only show teams who completed the game with no hints | Checkbox | Filters the board to teams that finished without using a single hint. Pairs well with Show number of hints received turned off |
| Show unnamed teams | Checkbox. Tooltip: "will display 'Unnamed team' where team name has not be set" | Includes teams that don't have a team name set; they render as "Unnamed team" |
| Show completion time | Checkbox | Adds the completion time column |
| Display by puzzle completion rate | Checkbox | Switches the ranking to be based on objective completion rate instead of completion time. Useful for events where most teams don't finish |
| Completion rate (%) | Number (0-100) | The minimum completion rate (in percent) for a team to appear on the board. Only shown when Display by puzzle completion rate is on |
Click Save changes to commit.
Activate or deactivate a leaderboard
- On the Leaderboard settings page, the top-right shows the current status as a ACTIVE (green) or INACTIVE (red) badge
- Click Activate to turn the leaderboard on, or Deactivate to turn it off
- Inactive leaderboards still configure but don't render publicly
Open the live leaderboard
- From Reporting and analytics > Events, click Leaderboard on the event card
- The board opens with the header [Event] Leaderboard, showing top teams in rank order
- Each row shows the rank, team name, and the metric columns you enabled in settings (completion time, players, hints)
- The top three ranks render with gold, silver, and bronze trophy icons; rank 4+ renders as a numeric rank
- Click View game details on any row to jump to that team's event details page
Switch to fullscreen mode
- From the live leaderboard, click Fullscreen at the top right
- The board opens at
/dashboard/game/leaderboard/fullscreenwith the chrome stripped down for venue display - Use this view on a TV or kiosk in your lobby
The fullscreen route is the same data, just with the surrounding navigation hidden so the board occupies the whole screen.
Audit a team's performance
- Find the team on the leaderboard
- Click View game details on their row
- The session detail page opens with everything captured during that team's run (timing, objectives timeline, host, photos, notes)
Useful for verifying record-setting times before announcing them to staff or social media.
Reference
Leaderboard settings page
| Element | Description |
|---|---|
| Page header | "Leaderboard settings for [event name]" |
| Status badge | ACTIVE (green) or INACTIVE (red) |
| Save changes | Commits configuration |
| Activate / Deactivate | Toggles whether the leaderboard renders for this event |
Settings fields
| Field | Type | Notes |
|---|---|---|
| Number of rows to show | Number input | Top N teams appear on the board |
| Show number of players | Checkbox | Adds the player-count column |
| Show number of hints received | Checkbox | Adds the hints column |
| Only show teams who completed the game with no hints | Checkbox | Filters to no-hint completions only |
| Show unnamed teams | Checkbox | Displays "Unnamed team" instead of hiding |
| Show completion time | Checkbox | Adds the completion-time column |
| Display by puzzle completion rate | Checkbox | Switches ranking to objective completion rate |
| Completion rate (%) | Number (0-100) | Minimum percent for a team to appear; only when ranking by completion rate |
Live leaderboard page
| Element | Description |
|---|---|
| Page header | "[Event] Leaderboard" |
| Fullscreen button | Top-right; opens the venue-display variant |
| Rank column | Trophy icons for top 3 (gold, silver, bronze); numeric rank for 4+ |
| Team name column | The configured team name, or "Unnamed team" when Show unnamed teams is on |
| Completion time | Minutes, when Show completion time is on |
| Number of players | Player count, when Show number of players is on |
| Number of hints | Hint count, when Show number of hints received is on |
| View game details | Per-row link to the session's event details page |
Fullscreen mode
| Element | Description |
|---|---|
| Route | /dashboard/game/leaderboard/fullscreen |
| Chrome | Hidden so the board fills the screen |
| Data | Same as the regular leaderboard |
Empty state
| State | Copy |
|---|---|
| No teams qualify | "Leaderboard not available." |
Mobile layout
On a small screen the board collapses to a card layout with rank in a colored icon box, team name as the headline, and metric values stacked. The View game details link still appears on each card.
Good to know
- Leaderboards are per event, not per group or per company. Each event has its own configuration. Want a "venue-wide leaderboard"? You'd need to pick one signature event to feature on a venue screen.
- The Display by puzzle completion rate mode is the way to go for events where most teams don't finish (e.g., escape rooms with low completion rates). Pairing it with a Completion rate (%) threshold of 50 means only teams who completed at least half the objectives appear on the board.
- The Only show teams who completed the game with no hints filter is great for prestige boards. Combine with hidden hint counts for a cleaner display.
- Unnamed teams are hidden by default. Toggle Show unnamed teams on if you want to display every result, even from teams that didn't set a team name. The label "Unnamed team" is hardcoded.
- The fullscreen mode is the same data with the chrome hidden. Use it on a TV in your lobby or front desk for a constant rotation of top scorers.
- Top three teams get gold, silver, and bronze trophy icons automatically. Rank 4 and below render as numeric ranks. There's no manual override.
- The leaderboard data isn't auto-refreshing. Reload the page to pick up new completions. For long-running displays, consider a browser auto-refresh extension or a kiosk app that reloads on a schedule.
- Activate / Deactivate is the master switch. An inactive leaderboard configures but doesn't render publicly. Use it to stage configuration changes before going live.
FAQ
Q: How do I make a leaderboard for a specific date range (e.g., "This month's top times")?
A: The leaderboard doesn't have a date filter today. It always shows top times across all completed sessions for the event. For date-scoped reporting, run an Events report from Reports instead.
Q: How do I rank teams across multiple events?
A: Cross-event leaderboards aren't supported. Each event has its own board. Pick a signature event for the venue screen.
Q: What if two teams have the same completion time?
A: Tiebreaks aren't configurable here. Teams with the same time appear in the order returned by the database (typically the earliest session first).
Q: My leaderboard isn't showing up on the venue screen. Why?
A: Check that the leaderboard is ACTIVE in settings. Inactive leaderboards configure but don't render. Also confirm the event has at least one completed session that meets the configured filters (no-hint, completion-rate threshold, etc.).
Q: How do I customize the colors and styling of the leaderboard?
A: There's no in-app theme customizer for leaderboards. The board uses your platform theme. For custom branding on a venue screen, use a browser kiosk extension to apply CSS overrides.
Q: Why doesn't my new top team show on the board?
A: A few possibilities: the team's session isn't marked completed, the team is unnamed (and Show unnamed teams is off), the team used hints (and Only show teams who completed with no hints is on), or the team's completion rate is below your configured threshold. Open event history to verify the session details.
Q: Can I see how the leaderboard ranking is computed?
A: With Display by puzzle completion rate off, ranking is by completion time (lowest is best). With it on, ranking is by puzzle completion rate (highest is best, with completion time as the secondary sort). Hint counts don't affect ranking; they're a column, not a tiebreak.