{"id":2460,"date":"2019-05-22T17:40:04","date_gmt":"2019-05-22T21:40:04","guid":{"rendered":"https:\/\/learndash.com\/support\/docs\/core\/quizzes\/quiz-leaderboard\/"},"modified":"2025-08-07T17:59:44","modified_gmt":"2025-08-07T21:59:44","password":"","slug":"quiz-leaderboard","status":"publish","type":"docs","link":"https:\/\/learndash.com\/support\/kb\/core\/quizzes\/quiz-leaderboard\/","title":{"rendered":"Quiz Leaderboard"},"content":{"rendered":"\n<p>The <strong>LearnDash Quiz Leaderboard<\/strong> feature allows quiz scores to be displayed publicly, so students can see how they rank among others. This friendly competition can help boost engagement and motivation to improve performance.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Before You Begin<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>The leaderboard is enabled <strong>individually per quiz<\/strong><\/li>\n\n\n\n<li>To protect against spam, enabling <strong>CAPTCHA<\/strong> is recommended (see below)<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">How to Enable the Leaderboard<\/h2>\n\n\n\n<p>To activate the leaderboard for a specific quiz:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Navigate to <strong>LearnDash LMS > Quizzes<\/strong><\/li>\n\n\n\n<li>Click on a quiz to edit<\/li>\n\n\n\n<li>Select the <strong>Settings<\/strong> tab<\/li>\n\n\n\n<li>Scroll to the <strong>Administrative and Data Handling Settings<\/strong> section<\/li>\n\n\n\n<li>Toggle on the <strong>Leaderboard<\/strong> option<\/li>\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\">Leaderboard Settings<\/h2>\n\n\n\n<p>Once the leaderboard is enabled, several customization options become available.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Who Can Apply?<\/h3>\n\n\n\n<p>Choose which users can appear on the leaderboard:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>All Users<\/strong> \u2013 Anyone who completes the quiz<\/li>\n\n\n\n<li><strong>Registered Users Only<\/strong> \u2013 Only logged-in users are included<\/li>\n\n\n\n<li><strong>Anonymous Users Only<\/strong> \u2013 For open-access quizzes \u26a0\ufe0f Anonymous users must enter a name and email to appear on the leaderboard.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Multiple Applications Per User<\/h3>\n\n\n\n<p>Allow students to submit multiple scores:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Enable this option only if <strong>Number of Retries Allowed<\/strong> is greater than one<\/li>\n\n\n\n<li>Set a <strong>waiting period (in minutes)<\/strong> between leaderboard submissions<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Automatic User Entry<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Enable to submit scores automatically after quiz completion<\/li>\n\n\n\n<li>Disable to require students to <strong>click a button<\/strong> to submit their score<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Number of Displayed Entries<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Set how many leaderboard entries are visible (e.g., top 5, top 10, etc.)<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Sort List By<\/h3>\n\n\n\n<p>Choose how leaderboard entries are sorted:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Best User (Top Score)<\/strong><\/li>\n\n\n\n<li><strong>Newest Entry<\/strong><\/li>\n\n\n\n<li><strong>Oldest Entry<\/strong><\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Display on Quiz Results Page<\/h3>\n\n\n\n<p>Choose how the leaderboard appears after the quiz is completed:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Below the Result Text<\/strong> \u2013 Automatically displayed beneath the results<\/li>\n\n\n\n<li><strong>In a Button<\/strong> \u2013 A \u201cShow Leaderboard\u201d button is shown; students click to reveal it<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Adding the Leaderboard to a Page or Post<\/h2>\n\n\n\n<p>To show the leaderboard outside the quiz results page:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Navigate to <strong>LearnDash LMS > Quizzes<\/strong><\/li>\n\n\n\n<li>Locate the quiz and copy the shortcode from the <strong>Shortcode<\/strong> column\n<ul class=\"wp-block-list\">\n<li>Example: <code>[LDAdvQuiz_toplist 27]<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Paste the shortcode into the content area of any WordPress page or post<\/li>\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\">Preventing Spam with CAPTCHA<\/h2>\n\n\n\n<p>To protect leaderboard submissions, LearnDash supports CAPTCHA verification.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">How to Enable CAPTCHA<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Install the <strong>Really Simple CAPTCHA<\/strong> plugin (available in the WordPress plugin directory)<\/li>\n\n\n\n<li>Once installed, CAPTCHA will appear on the leaderboard submission form<\/li>\n\n\n\n<li>This ensures that only real users can submit scores<br><\/li>\n<\/ol>\n\n\n\n<p class=\"has-theme-palette-7-background-color has-background\"><strong>Note:<\/strong> CAPTCHA is especially useful when anonymous submissions are allowed.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What the Student Sees<\/h2>\n\n\n\n<p>After completing a quiz:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Students will either see the leaderboard immediately or have the option to <strong>click a button<\/strong> to view it, depending on settings<\/li>\n\n\n\n<li>Anonymous users will be prompted to enter a name and email (if allowed)<\/li>\n<\/ul>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1386\" height=\"608\" src=\"https:\/\/learndash.com\/support\/wp-content\/uploads\/2019\/05\/learndash-quiz-leaderboard-frontend-example.jpg\" alt=\"LearnDash quiz leaderboard, frontend example\" class=\"wp-image-2567\" srcset=\"https:\/\/learndash.com\/support\/wp-content\/uploads\/2019\/05\/learndash-quiz-leaderboard-frontend-example.jpg 1386w, https:\/\/learndash.com\/support\/wp-content\/uploads\/2019\/05\/learndash-quiz-leaderboard-frontend-example-400x175.jpg 400w, https:\/\/learndash.com\/support\/wp-content\/uploads\/2019\/05\/learndash-quiz-leaderboard-frontend-example-768x337.jpg 768w, https:\/\/learndash.com\/support\/wp-content\/uploads\/2019\/05\/learndash-quiz-leaderboard-frontend-example-800x351.jpg 800w\" sizes=\"auto, (max-width: 1386px) 100vw, 1386px\" \/><\/figure><\/div>\n\n\n<h2 class=\"wp-block-heading\">Including Admins in the Leaderboard<\/h2>\n\n\n\n<p>By default, users with the <strong>Administrator<\/strong> role are excluded from quiz reporting and leaderboard rankings.<\/p>\n\n\n\n<p>To include administrators:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Navigate to <strong>LearnDash LMS > Settings<\/strong><\/li>\n\n\n\n<li>On the <strong>General<\/strong> tab, scroll to <strong>Admin User Settings<\/strong><\/li>\n\n\n\n<li>Toggle on the <strong>Include in Reports<\/strong> option<\/li>\n<\/ol>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"683\" height=\"277\" src=\"https:\/\/learndash.com\/support\/wp-content\/uploads\/2019\/05\/admin-user-settings_1.jpg\" alt=\"Admin user settings on LearnDash back end\" class=\"wp-image-3864\" srcset=\"https:\/\/learndash.com\/support\/wp-content\/uploads\/2019\/05\/admin-user-settings_1.jpg 683w, https:\/\/learndash.com\/support\/wp-content\/uploads\/2019\/05\/admin-user-settings_1-400x162.jpg 400w\" sizes=\"auto, (max-width: 683px) 100vw, 683px\" \/><\/figure><\/div>\n\n\n<h2 class=\"wp-block-heading\">Next Steps<\/h2>\n\n\n\n<p>Ready to boost learner engagement with a competitive edge? After enabling the leaderboard:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Review <a href=\"https:\/\/learndash.com\/support\/kb\/core\/quizzes\/quiz-display\/\">Quiz Display and Content Settings<\/a> to fine-tune grading, retries, and result displays<\/li>\n\n\n\n<li>Explore <a href=\"https:\/\/learndash.com\/support\/kb\/core\/questions\/questions\/#question-categories\">Using Question Categories<\/a> to diversify and randomize quiz content<\/li>\n\n\n\n<li>Want to highlight top performers elsewhere? Use the shortcode to display the leaderboard on a course homepage or sidebar<\/li>\n<\/ul>\n\n\n\n<p>Leaderboards are a great way to gamify learning and recognize high achievers, just be sure to set the right privacy and entry rules for your audience.<\/p>\n\n\n\n<p><\/p>\n\n\n\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>The LearnDash Quiz Leaderboard feature allows quiz scores to be displayed publicly, so students can see how they rank among others. This friendly competition can help boost engagement and motivation to improve performance. Before You Begin How to Enable the Leaderboard To activate the leaderboard for a specific quiz: Leaderboard Settings Once the leaderboard is&#8230;<\/p>\n","protected":false},"author":59,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_helpful_status":1,"_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_swpsp_post_exclude":false,"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"footnotes":""},"doc_category":[170],"doc_tag":[],"knowledge_base":[154],"class_list":["post-2460","docs","type-docs","status-publish","hentry","doc_category-quizzes","knowledge_base-core"],"year_month":"2026-04","word_count":554,"total_views":"5729","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"display_name":"Matt Cromwell","author_link":"https:\/\/learndash.com\/support\/author\/mattc\/"},"doc_category_info":[{"term_name":"Quizzes","term_url":"https:\/\/learndash.com\/support\/kb\/core\/quizzes\/"}],"doc_tag_info":[],"taxonomy_info":{"doc_category":[{"value":170,"label":"Quizzes"}],"knowledge_base":[{"value":154,"label":"LearnDash Core"}]},"featured_image_src_large":false,"comment_info":0,"knowledge_base_info":[{"term_name":"LearnDash Core","term_url":"https:\/\/learndash.com\/support\/kb\/core\/","term_slug":"core"}],"knowledge_base_slug":["core"],"_links":{"self":[{"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs\/2460","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/users\/59"}],"replies":[{"embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/comments?post=2460"}],"version-history":[{"count":11,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs\/2460\/revisions"}],"predecessor-version":[{"id":10365,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs\/2460\/revisions\/10365"}],"wp:attachment":[{"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/media?parent=2460"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/doc_category?post=2460"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/doc_tag?post=2460"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/knowledge_base?post=2460"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}