Quizzes

In this article

Quizzes

Quizzes provide a way for you to measure a user’s comprehension of the learning material in your course. LearnDash quizzes come with quite a few options to customize the experience. This section will cover all of those options in detail.

  • Global Settings
    Settings applied to all quizzes on your site
  • Quiz Builder
    Add, edit, remove & manage a quiz, and all of its questions
  • Questions & Question Types
    How to set up quiz questions & all available question types
  • Quiz Access & Progression
    Set access restrictions & control how a user progresses through a quiz
  • Display & Content Settings
    Customize several options for how a quiz appears to your users
  • Display Results
    Customize how quiz results are displayed & provide answer feedback
  • Custom Fields
    Collect additional information from users who take a quiz
  • Leaderboard
    Promote competition by displaying user results in a leaderboard
  • Email Notifications
    Notify users and/or admins when a quiz is completed

Global Quiz Settings

The LearnDash quiz settings screen is where you can set some global options that will apply to all quizzes on your site. Quiz settings are organized into a few sections, outlined below.

To access your global quiz settings:

  1. Navigate to LEARNDASH LMS > QUIZZES
  2. Click the Settings tab

LearnDash global quiz settings tab

Table of Contents [show]

Global Quiz Management & Display Settings

LearnDash quiz management & display settings

Quiz Builder

The quiz builder is enabled by default. It simplifies quiz creation and can save you a ton of time, especially for more complex quizzes with many questions.

It can be disabled, but we recommend leaving it enabled.

Learn how to use the quiz builder →

When the quiz builder is enabled, you have a few additional options:

  • Questions Displayed: This signifies the number of questions that will appear in the quiz builder, before showing pagination at the bottom. For large quizzes, decreasing this number could make your quizzes easier to manage with the builder.
  • Shared Quiz Questions: Enable this setting if you want to use the same question across multiple quizzes.

WARNING
Once shared quiz questions is enabled, it should not be disabled without careful consideration. Any question associated to multiple quizzes will lose its association if the setting is disabled.

Custom Quiz Time Formats

By default, LearnDash will use your default WordPress date & time format for quiz statistics & the quiz leaderboard. Toggle this setting on if you’d like to use a custom date/time format. Once enabled, you’ll have two options:

  • Statistic time format
  • Leaderboard time format

Each one can be set individually.

Quiz Template Management

If you are using quiz templates, this section allows you to delete a quiz template, or update an existing template’s title.

  1. Choose the quiz template from the dropdown menu
  2. (Optional) Edit the template title
  3. Click Update to update the title, or Delete to delete that template

Quiz Email Settings

LearnDash global quiz email settings

Please see our full documentation on quiz email notifications →

Quiz Taxonomies (Categories & Tags)

LearnDash quiz taxonomy global settings

Example of LearnDash categories & tags

Using quiz taxonomies is completely optional, but they provide an additional way to organize your quizzes.

  • LearnDash Quiz Categories:This enables you to organize your quizzes into custom categories that are only available for LearnDash quizzes.
  • LearnDash Quiz Tags: This enables you to organize your quizzes using custom tags that are only available for LearnDash quizzes.
  • WordPress Post Categories:This enables you to organize your quizzes using WordPress’ default category management system. These categories can be viewed & managed in the WordPress admin under POSTS > CATEGORIES. You can share them amongst both the Posts & Quizzes post types.
  • WordPress Post Tags: This enables you to organize your quizzes using WordPress’ default tag management system. These tags can be viewed & managed in the WordPress admin under POSTS > TAGS. You can share them amongst both the Posts & Quizzes post types.

If you’ve enabled these options, when you go to edit a quiz, you’ll see each of them in the sidebar of the editing screen. In the above screenshot, WordPress categories & tags are shown in pink, while LearnDash categories & tags are shown in blue.

WordPress has a good article on the difference between categories & tags, and when & how to use each one.

Managing Categories & Tags

You can manage (add, edit, or delete) the WordPress and LearnDash Categories & Tags via the Actions menu:

  1. Navigate to LEARNDASH LMS > QUIZZES
  2. Select the Actions dropdown menu
  3. Select your desired menu option

Quiz Custom Post Types

LearnDash quiz custom post type settings

These options will apply globally to all LearnDash quizzes on your site:

  • Quiz Search: Enable this setting if you want quizzes to be included in search results when using the default WordPress search form on the front-end of your site. In most cases, we recommend leaving this disabled.

NOTE
Quiz Search has nothing to do with Google search results. This setting only applies when using the built-in WordPress search form on your website.

  • Archive Page: Enable this setting if you want visitors to be able to access the default quiz archive page. When enabled, a preview of the URL is displayed. Note: The design of this page is controlled by your theme, not by LearnDash.

    • You need to re-save your permalinks after updating this setting.
    • In most cases, we recommend leaving this disabled.
  • RSS/Atom Feed: Enable this setting if you want to include LearnDash quizzes in the RSS feed of your site.
  • Editor Supported Settings: You can choose which features of WordPress you’d like to enable for the Quiz post type.
    • Featured Image
    • Comments
    • Custom Fields
    • Revisions

Quiz Builder

The LearnDash quiz builder provides a quick, intuitive way to add, edit, move & delete all the questions in your quiz. This article explains how to use every aspect of the quiz builder to make creating quizzes & managing questions a breeze.

NOTE
The quiz builder is enabled by default, but if you don’t see it when editing your quiz, double-check that it’s enabled in your global quiz settings.

Table of Contents [show]

Access the Quiz Builder

There are a few ways you can access the LearnDash quiz builder.

For Existing Quizzes

If you’ve already created a quiz:

  1. Navigate to LEARNDASH LMS > QUIZZES
  2. Hover over an existing quiz
  3. Click the “Builder” link

How to access LearnDash quiz builder from list page

Alternatively, you can click on the quiz title or “Edit” link to bring up the “Edit Quiz” page. Once there, click the “Builder” tab in the top navigation bar.

LearnDash quiz builder tab in admin

Creating Your First Quiz?

Add new quiz button in LearnDash

  1. Navigate to LEARNDASH LMS > QUIZZES
  2. Click the “Add New” button at the top of the page
  3. Click the “Builder” tab in the top navigation bar

Quiz Builder Overview

At the top of the quiz builder, you’ll see:

LearnDash quiz builder, top bar

  • The total number of questions in the quiz
  • A link to “Expand All” or “Collapse All” questions
    • This allows you to see all questions & answers at a glance, and more quickly rearrange, add or remove questions
  • An “Undo” link to undo any unwanted changes you’ve made

Then you’ll see all of your questions. This is where you’ll spend the majority of your time constructing your quiz.

Main area of the LearnDash quiz builder

Add Questions to Your Quiz

There are multiple ways to add questions with the quiz builder. This will depend on a few things:

  • if you’re sharing questions across multiple quizzes, and want to add existing ones
  • if you’re adding brand new questions
  • personal preference

New Questions

To add a brand new question to a quiz:

  1. At the bottom of the quiz builder, click the + New Question link
  2. Type the name of your question (internal use only)
  3. Hit ENTER, or click the “Add Question” button

How to add new question in LearnDash quiz builder admin

Existing Questions

All of your existing questions can be found in the “Questions” box in the sidebar. By default, your most recent questions are shown, but you can click “View all” to see all questions, or use the search box to find a specific question by its title.

NOTE
If you don’t see the questions box depicted below, click the settings cog icon icon to display the sidebar.

LearnDash quiz builder, questions metabox

There are multiple ways to add existing questions.

Add a single question: Hover over a question in the question box and click the “Add” button. This will add the question to the end of your quiz.

How to add a single question to a LearnDash quiz

Add multiple questions: Select the checkbox next to multiple questions, and then click the “Add Selected” button. This will add all selected questions to the end of your quiz.

Add multiple questions via LearnDash quiz builder

Drag & drop: If you’d like to add questions to a particular spot in your quiz, you can click & hold down your mouse, drag the question to the quiz builder in the spot you want it, and then release. This will place the question in your specified location in the quiz.

Drag & drop questions in the LearnDash quiz builder

Edit Questions

Questions have a few different parts to them, so let’s cover each area one at a time.

Question Title

Like we previously mentioned, the title is only for internal use, but it can be extremely helpful for the admin to find/edit questions on the backend.

Edit question title in quiz builder

To edit the question title in the quiz builder:

  1. Hover over the question whose title you’d like to edit
  2. Click the pencil icon
  3. Edit the title
  4. Hit ENTER, or click the “Save” button

For all other edits to the question, or its answers, you need to expand the question by clicking on the blue down arrow on the right. Alternatively, you can expand all questions at once using the “Expand All” link at the top of the quiz builder.

Question

How to edit a question in the LearnDash quiz builder

To edit the actual text of the question:

  1. Next to the Question, click the pencil icon
  2. Edit your question
  3. Click the “Save” button

Answers

Editing answers in the quiz builder will depend on the question type. Different types have different options. As soon as you select the question type, your answer options will update below.

Add Answers

The following question types provide the ability for you to add more than one answer:

  • single choice
  • multiple choice
  • sorting
  • matrix sorting

How to add new answer in LearnDash quiz builder

For these question types, you can add new answers directly in the builder.

  1. Click the + New Answer link
  2. Enter your new answer
  3. Click the “Add Answer” button

Edit Answers

Editing answers will look different, depending on the question type. However, all answers & answer options can be edited in the quiz builder by clicking the pencil icon.

Here’s an example editing an answer for a single choice question:

How to edit answers in LearnDash quiz builder

Select Correct Answers

For single choice & multiple choice questions, you can select one or more correct answers.

  1. To the right of each answer, you’ll see a “Correct” option
  2. For single choice questions, choose the single radio button that corresponds with the correct answer
  3. For multiple choice questions, choose each checkbox that corresponds with a correct answer

The correct answer(s) is displayed in bold in the quiz builder.

Move Answers

The following question types contain answers which can be reordered:

  • single choice
  • multiple choice
  • sorting
  • matrix sorting

How to rearrange/move answers in quiz builder

To rearrange the order of answers:

  1. Locate the 6 dots to the left of the answer
  2. Click, hold down your mouse, and drag the answer to a new location

Remove Answers

To remove an answer in the quiz builder:

  1. Hover over the answer you’d like to remove
  2. Click the red “Remove” link

How to remove answers in the quiz builder


For all other question types, the answer options vary. Please refer to our question types documentation to see all available options.

Points

How to edit question points in quiz builder

To edit the amount of available points for a question:

  1. Click the pencil icon next to “__ points”
  2. Edit available points
  3. Hit ENTER, or click the “Save” button

NOTE
Currently, you cannot set different points for each answer via the quiz builder. Please see this page for instructions.

Question Type

How to edit question type in LearnDash quiz builder

To edit the question type:

  1. Click on the question type dropdown menu
  2. Choose a new question type

The answer options will automatically update as soon as you change the question type.

Question Settings

Question settings are the same across all question types.

To access question settings in the quiz builder:

  • Look for the “Question Settings” link below the answers

LearnDash quiz builder, question settings

Since these settings are also available on the dedicated Edit Question page, please see the following documentation for:

  • Question hints
  • Custom correct/incorrect messages

Question Categories

Currently, these cannot be set within the quiz builder. Please see this page for instructions.


Finally, if you need to open a question’s dedicated edit screen:

  1. Hover over a question
  2. Click the blue “Edit” link

Edit & remove links in LearnDash quiz builder

NOTE
We recommend opening the question page in a new tab so you don’t lose any unsaved changes to your quiz.

Remove Questions

To remove a question from your quiz:

  1. Hover over the question
  2. Click the red “Remove” link

NOTE
This only removes the question from this particular quiz. It will still remain in your full list of questions, and if using it on another quiz, that quiz will not be affected.

Rearrange Questions

In addition to adding & editing questions, you can also use the quiz builder to move them around. You’ve got two options.

Drag & Drop

Immediately before each question, you’ll find an icon with 6 dots. When you hover over this icon, your cursor will turn into a hand. This means you can click, hold down, and drag the question to another place within your quiz.

Drag & drop questions to rearrange them

Arrows

Also located before each question, you’ll find up and down arrows above and below the drag & drop icon. Clicking these arrows will move the question either up or down.

Move questions in quiz builder using arrows

Quiz Questions

This article will explain all the various question types that can be used with LearnDash quizzes, how to set up your questions & answers, awarding points, hints, categories, the different options available for each question type, and more.

Table of Contents [show]

Access Questions

Every question you use in any quiz across your site is stored in one, central location. While you can use the quiz builder to add questions & configure your entire quiz, you can also modify questions on their own, dedicated page.

  1. Navigate to LEARNDASH LMS > QUESTIONS
  2. Click on any question to open it’s edit page

Filter Questions

LearnDash gives you the ability to filter your questions in a number of ways:

  • by question type
  • by question category
  • by the quiz it is assigned to (you can also view questions that are unassigned)

How to filter LearnDash quiz questions

Use the filter bar across the top of the All Questions page:

  1. Choose the filters you want
  2. Click the “Filter” button

Choose Question Type

When creating a new quiz question, one of the first things you’ll want to do is choose your question type. LearnDash offers the following question types:

  • Single choice
  • Multiple choice
  • Free choice
  • Sorting choice
  • Matrix sorting choice
  • Fill in the blank
  • Assessment (survey)
  • Essay (open answer)

To select your question type, look for the Answer type box in the sidebar. Select your type:

Choose LearnDash question type

Question Title & Text

The question title is only for internal use. It is not displayed to the user.

The question text is where you actually type the question you have for the user. This uses the classic WordPress editor, so you can insert images, format your text & use custom HTML.

LearnDash question title & text area

Points to be Awarded

Points are available for all question types. This field is required for all questions. It defaults to 1, but can also be set to 0. Points are only awarded when the question is answered correctly.

Points can also be hidden in your quiz display settings.

Choose points to be awarded for a question

To adjust points for a question:

  1. Find the Points box in the sidebar
  2. Update the number of points to be awarded

If you’d like to award a different numbers of points based on the specific answer given:

  1. Check the Different points for each answer box
  2. In the Answers box, where you add your answers, you’ll see a box labeled “Points”
  3. Enter the number of points to be awarded for each specific answer

Question Categories

Question categories are available for all question types. They are completely optional, but you can use them to:

  • better organize all of your quiz questions
  • provide the user with quiz statistics, broken down by category

LearnDash question category selection

To place a question in a category:

  1. Find the Question Category box in the sidebar
  2. Click the dropdown
  3. Choose an existing category, or select “Create new category” and give your new category a name

Update or Delete Categories

To delete a question category, or update its title:

  1. Navigate to LEARNDASH LMS > QUESTIONS
  2. Click on the Settings tab
  3. In the Question Taxonomies section, click the dropdown to “Select a category”
  4. Click the Delete button to delete it, or
  5. Update its title and then click Update

How to update a LearnDash question taxonomy title

At the end of a quiz, you can choose to display to percentage score the user received in each category of questions:

LearnDash quiz category, results display on frontend

Hints

Add hint for LearnDash quiz question

Hints are available for all question types. They are completely optional, but can help direct a user in the right direction when answering a question. When enabled, a button will appear below the question. Clicking that button will reveal a popup with the hint.

To enable a hint for a question:

  1. On the Edit Question screen, scroll down to the Hint box
  2. Check the box to Activate hint for this question?
  3. Enter your hint in the box
    Hints use the classic WordPress editor, so you can include images, lists, formatting & custom HTML.

Quiz Question Types

Single Choice

Single choice means there is only one correct answer. This is the most common question format for standardized tests. You should also use this question type for True or False questions.

  • There is no limit to the number of incorrect answers you provide
  • Choose the correct answer by selecting the radio button for “Correct”
  • Check the “Allow HTML” box if you’d like to use HTML in your answer
  • Add images or other media by clicking the “Add Media” button
  • Delete an answer by clicking the “Delete answer” button
  • Add a new answer by clicking the “Add new answer” button
  • Move answers around by long-pressing the “Move” button and dragging the answer up or down

Setting up a single choice question in the admin area looks like this:

LearnDash single choice question in admin

Here’s an example of what the user will see. This uses the LearnDash 3.0 themewith the correct answer selected.

LearnDash single choice question frontend example

Multiple Choice

Multiple choice questions support multiple correct answers. In order for the question to be marked correct, users must select ALL of the correct answers. If they only select some correct answers, then the question is marked incorrect.

  • There is no limit to the number of correct or incorrect answers you provide
  • The rest of the setup options are the same as single choice questions

Setting up a multiple choice question in the admin area looks like this:

LearnDash multiple choice question, admin setup

Here’s an example of what the user will see. This uses the LearnDash 3.0 theme with the correct answers selected.

LearnDash multiple choice question, frontend example

Subtract Points for Incorrect Answer
You can choose to subtract points when the user selects an incorrect answer.

  1. In the Points box, enable the option for “Different points for each answer”
  2. Provide a negative number of points to the incorrect answer
  3. This value will then be subtracted from the question’s total points

Negative Scoring Setting

 

Free Choice

Free choice questions give the user an input field where they must type the correct answer.

  • You can choose to accept only one answer, or multiple possible answers
  • Answers may be one word or multiple words
  • Capitalization does not matter. BLUE, Blue and blue are all scored the same.

Example: If you ask “What color is the sun?”, you can choose to accept yellow, orange or white. If the user enters any one of these answers, the question is marked correct.

Setting up a free choice question in the admin area looks like this:

LearnDash free choice question, admin setup

Here’s an example of what the user will see. This uses the LearnDash 3.0 theme with the correct answers selected.

LearnDash free choice question, frontend example

Sorting Choice

Sorting choice questions ask the user to place a series of answers in the correct order. When creating the question, the order of the answers in the backend will be considered the correct order.

Setting up a sorting choice question in the admin area looks like this:

LearnDash sorting choice question, admin setup

Here’s an example of what the user will see. This uses the LearnDash 3.0 theme.

LearnDash sorting choice question, frontend example

Matrix Sorting Choice (Matching)

Matrix sorting questions should be used when you want the user to match two items together. There are two parts to a matrix sorting question:

  • Criterion: These are static & cannot be moved.
  • Sort elements: These are what users will drag & drop to the correct criterion.

Each sort element must be unique, and only one-to-one associations are supported.

Your answer area will be set up like a table, with the criterion on the left, and an open area to drag & drop sort elements on the right. You have the option to set a percentage width for the criterion column.

Setting up a matrix sorting choice question in the admin area looks like this (the example uses images for the criterion):

LearnDash matrix sorting question, admin setup

Here’s an example of what the user will see. This uses the LearnDash 3.0 theme.

LearnDash matrix sorting choice question, frontend example

Fill in the Blank

Fill in the Blank questions allow you to insert a blank line(s) in the middle of a sentence or paragraph. Users then type the correct answer into this empty field.

  • If more than one blank exists, all blanks must be answered correctly for the entire question to be marked correct.
  • Capitalization does not matter. PLAY, Play and play are all scored the same.
  • Blank spaces are created by providing the correct answer inside of curly braces { and }.

Example Format

  • Admin Setup: {play} soccer.
  • User Sees: I ____ soccer.

The correct answer is “play”.

Multiple Possible Answers

To allow for multiple possible answers, enclose each possible answer with square brackets [ and ]. You still use { and } to create the blank space.

{[play][love][hate]} soccer.

In this example, the user can enter “play,” “love” or “hate,” and they would all be accepted as correct.

Different Points Per Answer

If the “Different points for each answer” option is selected, you can assign points to each possible answer. Otherwise, 1 point will be awarded for each correct answer. To assign points to an answer, enter the pipe character | immediately following the answer, and then enter the number of points.

{play} soccer, with a {ball|3}.

In this example, the answer “play” is awarded 1 point, and “ball” is awarded 3 points.

Setting up a fill in the blank question in the admin area looks like this:

LearnDash fill in the blank question, admin setup

Here’s an example of a fill in the blank question used for math equations, where there is only one possible correct answer for each blank.

LearnDash fill in the blank question, frontend example

Assessment (Survey)

Assessment questions allow for the use of a Likert scale. This question type is perfect for surveys, or any time you’re asking a user to rate something on a scale.

  • Only one answer may be selected
  • You can add text/images before and/or after the scale
  • There is no limit to the number of options available in the assessment
  • Enclose the entire assessment with curly braces { and }
  • Enclose each individual answer with square brackets [ and ]
  • The maximum possible score is equal to the total number of options

Examples:

  1. less true { [1] [2] [3] [4] [5] } more true
  2. { [disagree] [not sure] [agree] }

Example 1: 1 is the least true; it’s worth 1 point. 5 is the most true; it’s worth 5 points.

Example 2: disagree is worth 1 point. not sure is worth 2 points. agree is worth 3 points.

TIP
This type of question is great for pre-course or end-of-course surveys.

Setting up an assessment question in the admin area looks like this:

LearnDash assessment question, admin setup

Here’s what the user sees:

LearnDash assessment question, frontend example

Essay / Open Answer

Essay questions allow the user to enter a free-form answer. You can choose between two types of essay questions:

  • Text Box: Displays a