Leaderboards
Public Leaderboards
Display auto-updating leaderboards on your website or lobby TV — share a public link or embed with a single script tag
Every room's leaderboard has a public page that anyone can view — no login required. Embed it on your website to motivate prospective customers, or display it on a lobby TV to build excitement before games. Rankings update automatically as new groups complete their games. To customize colors and display options, see Customize Leaderboard.
The public leaderboard page
Your public leaderboard lives at a URL like escapekit.co/leaderboards/your-location-slug/. Anyone with the link can view it — no login required.
The page shows:
- A room selector so visitors can switch between rooms (when you have multiple rooms)
- All Time and Last 30 Days period filters
- Each entry displays the team's rank, team photo (when available), team name, date, player count, and the ranking metrics configured for that room
Example: Many venues display the public leaderboard on a TV in their lobby using the public URL. Customers see the rankings while they wait, building excitement and competitive energy before their game even starts.
Embed on your website
The Website Integration section in the Leaderboards settings shows a script tag you can add to your website. The widget loads your leaderboard inside a responsive iframe that auto-resizes to fit its content.
In the Website Integration section, click the script tag input field to select the full code. Copy it to your clipboard.
The code looks like this:
html
<script async type="text/javascript"
src="https://your-escapekit-url/lbwidget.js?lid=your-location-slug&active_only=true">
</script>
The URL in your embed code will already have your correct domain filled in — just copy and paste it as-is.
Add the script tag to any page on your website where you want the leaderboard to appear. Paste it in the HTML at the exact position where you want the widget — the iframe will render inline at that location.
Publish or deploy your website changes. The leaderboard widget will load automatically.
The widget is fully responsive and adjusts its height based on the leaderboard content. Visitors can switch between rooms and time periods directly within the embedded widget.
Pro Tip: Add the leaderboard embed to your "Book Now" or room detail pages. Prospective customers see the competition and are more likely to book.
Common issues
Leaderboard is empty — Only groups that escaped appear. If no groups have escaped for a room, the leaderboard has no entries. Check that game results include an escape result and that Include on leaderboard is enabled on the group.
Changes not showing on your website — The embed code must be pasted into your website's HTML and deployed. Copying the code from the settings page doesn't automatically add it to your site.
Wrong room showing first — The page defaults to the first room. Visitors can switch rooms using the room selector at the top.
Related pages
- Customize Leaderboard — Configure ranking metrics and appearance settings
- The Debrief Page — Where players see their ranking after a game
- Completing a Game — How game results feed into leaderboards