1. Home
  2. Docs
  3. LearnDash Core
  4. Quizzes
  5. Quiz Leaderboard

Quiz Leaderboard

The quiz leaderboard provides a way for you to display user’s scores to everyone who takes a quiz. Users can see where they stack up against one another, and ideally, they’ll feel more inclined to excel at the quiz and see their name atop the leaderboard.

Enable the Leaderboard

Quiz leaderboards are enabled on a quiz-by-quiz basis.

  1. Navigate to LEARNDASH LMS > QUIZZES
  2. Click on the quiz you’d like to enable the leaderboard for
  3. Click on the Settings tab
  4. Scroll down to the Administrative and Data Handling Settings section
  5. Enable the toggle for Leaderboard

Leaderboard Settings

Who Can Apply?: This determines who can submit their score to the leaderboard.

  • All users
  • Registered users only
  • Anonymous users only (for “Open” courses where users don’t need to be logged in). Anonymous users are required to enter their name & email.

Multiple Applications per user: Enable this option to allow the same user to submit multiple scores to the leaderboard.

  • Enter the number of minutes the user has to wait before they can submit another score

Automatic user entry: Enable this option to automatically submit the user’s score to the leaderboard. If left disabled, a button will be available for the user to click to submit their score.

Number of displayed entries: This refers to the number of entries that are present in the leaderboard when it is displayed to the users.

Sort list by?: This determines the sort order when the leaderboard is displayed to the users.

  • Best user (top score)
  • Newest entry
  • Oldest entry

Display on Quiz results page: Enable this option to display the leaderboard on the quiz results page. You have two options for how it is displayed:

  • Below the result text: The leaderboard is displayed on the page by default.
  • In a button: A “Show Leaderboard” button is displayed at the bottom of the quiz results, and must be clicked to display the leaderboard.

There is also the option to insert the leaderboard onto any WordPress page or post by using a shortcode:

  1. Navigate to LEARNDASH LMS > QUIZZES
  2. Locate the desired quiz
  3. In the Shortcode column, copy the leaderboard shortcode
    (example: [LDAdvQuiz_toplist 27])
  4. Paste the shortcode into the text editor of the desired page

What the User Sees

Here’s what the user sees after completing a quiz. This example displays the leaderboard after the “Show Leaderboard” button is clicked.

LearnDash quiz leaderboard, frontend example

 

Was this article helpful to you?

How can we help?