Leaderboards and Gamification
Leaderboards add a competitive element to your quizzes, motivating respondents to achieve higher scores. Combined with badges, they create a gamified experience that boosts engagement and completion rates.
Enabling leaderboards
- Open your quiz in the builder.
- Go to Results → Leaderboard.
- Toggle Enable Leaderboard on.
- Configure the settings below.
Leaderboards are available for Scored, Trivia, and Assessment quiz types. You can also ask respondents for a name so their entry is labelled.
Configuration
| Setting | Type | Description | Default |
|---|---|---|---|
showLeaderboard | boolean | Turn the leaderboard on for the quiz | false |
requireNameForLeaderboard | boolean | Ask respondents to enter a name so it appears on the leaderboard | false |
Entries are ranked by score automatically. When you fetch the leaderboard, you can cap how many entries come back with the limit query parameter (up to 100).
Badge system
Badges reward respondents for achievements. They appear on the result screen and next to the respondent’s name on the leaderboard.
| Badge | Trigger | Description |
|---|---|---|
| First Place | Rank #1 | Currently holding the top spot on the leaderboard |
| Perfect Score | 100% score | Awarded for answering every question correctly |
| Speed Demon | Fastest completion | Awarded to the fastest finisher |
| Early Bird | First to complete | Among the first respondents to complete the quiz |
Ranking display
The leaderboard displays on the result screen after submission. Each entry shows:
- Rank number (1st, 2nd, 3rd with medal icons for the top three).
- Name of the respondent.
- Score achieved on the quiz.
- Badges earned by the respondent.
The current respondent’s entry is highlighted so they can immediately see their ranking.
Where the leaderboard appears
When showLeaderboard is on for a published quiz, the leaderboard shows on the result screen after a respondent submits, with their own entry highlighted. Anyone who can take the quiz can see the standings, which makes it a great fit for marketing quizzes and social sharing. If the quiz is not published or the leaderboard is off, no standings are shown.