Create a leaderboard

Rank your audience based on quiz scores, predictor accuracy, or minigame scores. A leaderboard connects to one or more published quizzes, predictors, or minigames and displays a ranked list of participants. You can create a leaderboard as a standalone Riddle (embedded separately on your site) or add one directly to a quiz's result page.

When to use a leaderboard: Choose this when you want competition between participants – recurring quiz challenges, prediction leagues, or training assessments where ranking matters. You can use a full name/email form for verified leaderboards, or just a nickname for arcade-style setups.

Leaderboard setup

1. Create a Riddle and publish it.
   
   Note: While you can collect names and emails for leaderboard entries, they are no longer required. You can create arcade-style leaderboards where your audience only needs to enter a nickname.
2. In the Riddle Creator, click on CREATE RIDDLE, select Leaderboard, and click on Create Leaderboard from scratch.
   
   
3. Enter or edit the title in the Enter your title field.
   
4. Click on Connect your Riddles here and then CONNECT RIDDLES.
   
5. Choose a Riddle from the list, using the searchbar if needed, and click on the plus icon.
   
   Note: You can connect quizzes, predictors, and minigames. A minigame that only contains Wheel of Fortune blocks can't be selected – the Wheel of Fortune awards prizes instead of points, so there is no score to rank.
6. Click on SAVE & CLOSE to finish the setup, or SAVE & CONNECT MORE and repeat step six.
   
   Connecting more than one Riddle to the same leaderboard is available on Enterprise plans. See Connect multiple Riddles below.
7. Click on the minus icon to remove a connected Riddle.
   
8. In the pop-up that appears, click on DELETE to confirm that all associated scores will be removed from the leaderboards.
   
9. Publish your leaderboard.
   
10. Embed your leaderboard.
    

Connect multiple Riddles (seasons, multi-quiz)

One leaderboard can rank the scores of several Riddles. Use this for:

• Season rankings: a prediction league where every match day is its own predictor, ranked in one table for the whole season.
• Weekly quiz series: a new quiz every week, with one leaderboard that keeps the ranking across the whole series.
• Training programs: several assessments, one leaderboard, so you see who leads over the entire course.

1. Open your leaderboard, click on Connect your Riddles here and then on CONNECT RIDDLES.
2. Choose the next Riddle from the list and click on the plus icon.
3. Click on SAVE & CONNECT MORE to add further Riddles, or SAVE & CLOSE when you are done.
   
4. Publish the leaderboard again. The Connect a Riddle panel now lists every connected Riddle.
   

Only plays after the connection count for each Riddle, and a person's best result in a Riddle is the one that appears on the leaderboard. On Pro and Business plans, one Riddle can be connected per leaderboard. If you try to connect a second one, the Creator shows an upgrade notice for the Enterprise plan.

Change the podium colors

1. Click on the circles on the right of the top three places in the leaderboard.
   
2. Select a color or insert a HEX code and click on APPLY.
   
   The default colors are gold for first place, silver for second, bronze for third.

Security and privacy settings

You can customize how your audience participates in your leaderboard:

Disable 2FA verification

For new leaderboards, 2FA (two-factor authentication) is disabled by default, as we found your audience typically uses leaderboards for fun and engagement rather than serious competitions where 2FA is necessary.

1. Go to the Settings section and click on Leaderboard: Security / Privacy.
2. Disable Require OTP verification to allow your audience to participate without email confirmation.

Remove email requirement

Create an arcade-style leaderboard where your audience only needs to enter a nickname:

1. Go to the Settings section and click on Leaderboard: Security / Privacy.
2. Disable Require email to remove the email mapping.
3. Your audience can now participate with just a nickname, and emails won't be required or displayed.

Filter bad words in nicknames

Keep inappropriate nicknames off your leaderboard.

1. Go to the Settings section and click on Leaderboard: Security / Privacy.
2. Enable Bad word filter for nicknames. Nicknames are then checked against a built-in list of common profanity – the google-profanity-words list, which you can review to see exactly which words are blocked. Your audience can't submit the connected form with a nickname that contains a blocked word, and they're prompted to choose a different one.
3. (Optional) Enable Custom bad word filter to also block your own terms – enter a comma-separated list of words or strings you don't want used.

My leaderboard shows no results

• Only plays after the connection count. A leaderboard only shows plays that happened after you connected the Riddle. Plays from before the connection are not included, so a newly connected leaderboard starts empty until someone plays again.
• Resetting won't help. Resetting stats or deleting leads is separate from the leaderboard and won't bring earlier plays in.
• Check the connection and the status. Make sure the right Riddle is connected and that both the Riddle and the leaderboard are published.

Ideas and extra information

1. Create weekly, monthly, or even ongoing cumulative leaderboards that connect different Riddles and motivate your audience to keep playing.
2. A person's highest score is always the one that's counted on the leaderboard. If someone gets 50 points the first time they play, for example, and then 70 points the second time, the 70 will be on the leaderboard, not 50.
3. You can play a quiz, predictor, or minigame multiple times. Only your best result appears on the leaderboard.

Related articles:

• Configure scoring
• Customize the display
• Analyze a leaderboard