Adding a leaderboard is a powerful way to boost engagement and foster a sense of competition. It's especially effective for games involving scores or points, but it can also add excitement to any campaign type by encouraging participants to improve their rank.

Setting up a leaderboard is a three-step process: first, you'll add a field to collect player names; second, you'll add a button for users to open the leaderboard; and third, you'll customize its appearance.

Step 1: Add the 'Leaderboard Name' Field to Your Form

The leaderboard needs a specific piece of data to display for each participant. You must add the 'Leaderboard Name' field to your registration form to collect this.

1. In the campaign editor, select your Registration Form element to open its settings.
2. Click into the Fields toggle 
3. Click to add a new field and choose the 'Leaderboard Name' field type.
4. Drag and drop the field to your desired location within the form.
5. (Optional) You can change the 'Label' of this field to something more user-friendly, like "Enter Your Name" or "Nickname".

Step 2: Add a Leaderboard Button to a Screen

Once you're collecting names, you need to give users a way to view the leaderboard. This is done by adding a special 'Leaderboard' button, typically on the 'End Screen' or 'Result Screen'.

1. On your chosen screen, click to add a new element and select the 'Leaderboard Button' element type.
2. A new button will be added to your screen. You can customize its text, color, and style just like a regular button.
3. The button's function is automatically set to 'Open leaderboard' and is ready to use.

Step 3: Customize the Leaderboard's Design

You can customize the appearance of the leaderboard pop-up from a central location. Navigate to Extras → Leaderboard in the main campaign editor.

Text Styles & Headers

Customize the look and feel of your leaderboard's titles and table structure.

• Modal Header: Change the main title text (e.g., "Top Players"), font, color, and size.
• Table: Change the background and text color of the table's header row. You can also edit the labels for each column (e.g., change 'Rank' to 'Placement').
• Rows: Set alternating colors for the rows to improve readability, and customize the text color.

Display Settings

Control what data is shown and how players are ranked.

• Columns to Display: Use the toggles to show or hide the 'Score' and 'Time' columns. Using 'Time' as a tie-breaker is a common strategy when two players have the same score.
• Number of Players: Choose to display the Top 10, 100, or 500 participants.
• Ranking Logic: Decide how the list is sorted.
  • Based on Score: The default option, best for skill-based games.
  • Based on Time: Best for speed-based challenges where the fastest time wins.
  • Based on Score and Time: A combined logic that rewards both skill and speed.