Author 诗语

Quiz Results Display

The quiz results page is where users land immediately after they finish a quiz. There are quite a few elements on this page, and you can control which ones to display.

Compare the user』s score to the average score for the quiz
Mark correct & incorrect answers
Display custom feedback messages
Display overall score, score by category, X of Y answers correct, time spent and more

Table of Contents [show]1 How to Access Settings2 Quiz Result Message(s)3 Restart Quiz Button4 Custom Results Display5 Custom Answer Feedback5.1 Correct / Incorrect Messages5.1.1 Configure Messages5.2 Correct / Incorrect Answer Marks5.3 View Questions Button5.4 Was this article helpful to you?
How to Access Settings

Navigate to LEARNDASH LMS > QUIZZES
Click on the quiz you』d like to edit
Click on the Settings tab
Locate the Results Page Display section

NOTE
Quiz results page display settings are set on a quiz-by-quiz basis. They cannot be set globally.
Here』s an example of most of the available options. We』ll cover them all below.

Quiz Result Message(s)
This feature, sometimes referred to as 「graduation levels,」 allows you to display a custom message to the user on the quiz results page.

Choose to show just one, universal message to everyone
Show different messages, based on the score the user received on the quiz
Add as many levels as you』d like (technically, the maximum is 100)
For each level, set a minimum score (%) that must be attained in order for the user to see the message

To display a quiz result message(s):

Enable the Result Message(s) setting
If you want to show the same message to everyone, just enter a message in the first box, and that』s it

Now let』s use a different example with multiple messages:

Display a 「please try again」 message to users who score between 0 and 80%
Display a 「you passed」 message to users who score between 81% and 89%
Display a 「you earned a certificate」 message to users who score between 90 and 100%

After enabling the Result Message(s) setting:

Enter your message for the 0 to 80% group in the first box
Click the + Add graduation link at the bottom of the box
Enter 81 in the 「From ___ % score, display this message:」 box
Add your message for the 81% to 89% group
Click the + Add graduation link at the bottom of the box
Enter 90 in the 「From ___ % score, display this message:」 box
Add your message for the 90% to 100% group

Now you have 3 separate messages set up. Every single user will receive a message, but the message will be customized based on their score.
Restart Quiz Button
Enable this setting to show a 「Restart Quiz」 button on the results page, after a user finishes a quiz.
Custom Results Display
There are several aspects of the quiz results page that you can customize. Choose to show or hide any of the following elements:

Average Score: Displays a bar graph with Your score compared to the Average score of all users who have taken this quiz
Category Score: Displays the score (in percentage) broken down by question category
Overall Score: Displays the number of points earned, possible points available & percentage score. If essays still need to be graded, a message will be shown in this area as well.
No. of Correct Answers: Displays the number of questions answered correctly, out of the total number of questions
Time Spent: Displays the time it took the user to complete the quiz

NOTE
If you leave the Custom Results Display setting turned off, all elements will be shown.
Custom Answer Feedback
When enabling custom answer feedback, you can decide what type of feedback to provide to the user at the end of a quiz. Some examples include:

Only display a final score (hide all questions)
Show the user which answers were correct & incorrect
Display a custom message beneath each question

Please familiarize yourself with the following elements. We』ll discuss them below.

Correct / Incorrect Messages
Correct or incorrect messages can be shown beneath each quiz question.

If the answer is correct, the word 「Correct」 will appear at the top of the message
If the answer is incorrect, the word 「Incorrect」 will appear at the top of the message
Beneath either 「Correct」 or 「Incorrect,」 you may add a custom message for each question
Choose to show one message for correct, and a different one for incorrect, OR
Choose to display the same message, regardless of correct/incorrect

Configure Messages
If you want to display correct/incorrect messages after each question, you need to set them up first.

Navigate to LEARNDASH LMS > QUESTIONS
Click on the question you』d like to add a message for
Scroll down to the Message with the correct answer section
(Optional) Check the Same text for… box if you』d like to only show one message, regardless of correct/incorrect
Enter your message in the editor. Images & other HTML are supported.
(Optional) If you left the box unchecked in step 4, enter a different message for when the user gets the question incorrect

All of this is also available right from within the quiz builder.
Correct / Incorrect Answer Marks
Answer marks provide the user feedback on each question. Green is used to indicate correct answers, while red is used to indicate incorrect answers. If you allow users to retake the quiz, and you don』t want to give away the answers, you can disable answer marks. They』ll still be able to see the answers they provided, they just won』t know if it was correct or incorrect.
View Questions Button
If disabled, the 「View questions」 button will not appear on the results page, and users will not be able to review the questions. Only the information you have enabled in the previous section, 「Custom Results Display,」 will be shown.
To review the previously mentioned elements, here are the settings responsible to make these possible:

Only display a final score (hide all questions) – View Questions Button turned off
Show the user which answers were correct & incorrect – Correct / Incorrect Answer Marks turned on
Display a custom message beneath each question- Correct / Incorrect Messages turned on

Depending on your preference, you can have any combination  of these settings on or off at the same time. For example, if you want to display a correct/incorrect message and the correct/incorrect answer marks but not give your users the ability to review the questions, turn the View Questions Button off, and the other two on.
NOTE
If you leave the Custom Answer Feedback setting turned off, all elements will be enabled & displayed.

Was this article helpful to you?

Yes

No

Focus Mode

NOTE
This feature was introduced in LearnDash 3.0 and works with the new LearnDash 3.0 template. This feature does not work with the Legacy template.
Focus Mode aims to eliminate distractions & streamline your user』s learning experience – increasing learning retention and completion rates.
Table of Contents [show]1 Where It』s Applied2 What It Does3 Enable Focus Mode3.1 Focus Mode Content Width4 Upload a Logo5 Focus Mode Menu5.1 Adding Menu Items6 FAQ6.1 Was this article helpful to you?
Where It』s Applied
Focus Mode is applied to the following types of LearnDash pages:

lessons
topics
quizzes
assignments

Your course page will not change. It will continue to use the layout that you have chosen for your WordPress theme.
What It Does
When you enable Focus Mode, here is what will change on your site:
✅ Focus Mode is applied on all screen sizes (desktop, tablet & mobile)
✅ Main navigation & footer elements are removed from the page
✅ Any sidebars, if present, are also removed from the page
✅ Course navigation is always visible in a sidebar tray
✅ Course progress is always visible at the top of the screen
✅ Next/Previous lesson & topic navigation is always available at the top of the screen
✅ Mark Complete button is always visible at the top of the screen
✅ User』s avatar is shown in the top navigation, along with 「Course Home」 and 「Logout」 links
Here』s what Focus Mode looks like on a desktop:
Example of Focus Mode applied on desktop
Here』s what it looks like on a mobile device:
Example of Focus Mode applied on mobile
Focus Mode』s mobile menu tray
Enable Focus Mode
There are three important steps in order to enable focus mode:

You must be using LearnDash 3.0 or higher
You must be using the 「LearnDash 3.0」 template
You need to enable the Enable Focus Mode option in the LearnDash general settings

Focus Mode Content Width

When Focus Mode is enabled you have the option to specify the width of the content container. This refers to the width of the actual lesson content and not the width of Focus Mode itself, which will still take up the full screen.
The options include:

Default (960px) – Recommended
Narrow (768px)
Wide (1180px)
Extra-wide (1600px)
Full-width

Upload a Logo
While not required, we recommend uploading a logo to use with focus mode. This logo will appear in the top-corner of all lesson, topic & quiz pages when focus mode is enabled.
To upload a logo:

Navigate to LEARNDASH LMS > SETTINGS
In the Design & Content Elements section, look for Logo Upload
Click the Select image button
Choose an image from your Media Library, or upload a new one
Click Use this image at the bottom
Be sure to save your changes

You can remove your image by clicking the X, or upload a new one by repeating the steps above.

Focus Mode Menu
At the top-right of Focus Mode there is a custom menu that appears when hovering over the profile image (NOTE: the image that is displayed is taken from Gravatar). By default there are two menu choices:

Course Home – this takes the user back to the course page
Logout – this logs the user out of the site

Adding Menu Items
You can add as many custom menu items as you want to the Focus Mode Menu:

Navigate to APPEARANCE > MENUS
Click the Create a new menu link
Under Menu Settings, select LearnDash: Focus Mode Dropdown
Create/add your new menu items
Click Save Menu

NOTE
See the WordPress Menu User Guide if you do not already know how to create a menu in WordPress.
Any menu item that you add to the Focus Mode Menu will display between the default Course Home and Logout menu options. For example, if you added two new menu items then they would look like this:

At this point, when using Focus Mode, we don』t recommend adding sub-menu items since this mode does not support a hierarchical display unlike the usual navigation menus. The Focus Mode Menu does not distinguish between Parent Items and Child Items, i.e., main menu items and sub-menu items.
For example, if you add one menu item and a sub-menu item below that:

Both items will display on the same level, one on top of the other, as shown below:

FAQ
The logo in Focus Mode links to my homepage, can I change this?
Yes. You can use these filters for modifying the Focus Mode logo URL.
Is it possible to enable comments in Focus Mode?
Yes. You can allow comments on Focus Mode content (i.e. Lessons). For example, if you wanted to enable comments on Lessons:

Navigate to LEARNDASH LMS > LESSONS
Click on Settings
From Editor Supported Settings, ensure Comments are selected
Click Save

When editing a Lesson, you will see the Discussion meta box below the content editor where you can select Allow Comments.

Was this article helpful to you?

Yes

No

Enable Assignments

Assignments may be enabled for each individual lesson and/or topic within your course. They are completely optional, but provide an additional way to monitor the user』s comprehension of course material.
This article will explain how to enable assignment uploads so that users can submit assignments for you to review. If you』ve already done this, check out our article on managing assignments.
Table of Contents [show]1 Overview1.1 What the User Sees2 Additional Settings2.1 File extensions2.2 File size limit2.3 Points2.4 Grading Type2.4.1 Limit number of uploaded assignments2.4.2 Allow file deletion2.5 Was this article helpful to you?
Overview
Since assignment uploads are enabled on a lesson-by-lesson and topic-by-topic basis, you first need to navigate to the lesson or topic in which you』d like to ask for an assignment to be submitted.
For the rest of this article, we』ll use a lesson as the example, but the same instructions apply for topics.

Navigate to LEARNDASH LMS > LESSONS
Click on the lesson you』d like to enable assignment uploads for
Click the Settings tab
Under Display & Content Options, enable the Assignment Uploads setting

NOTE
Assignment uploads can only be enabled if both video progression and lesson timer are disabled.
What the User Sees
When you enable assignment uploads, a new box will appear at the bottom of the lesson page, below any page content you』ve added. This way you can include specific instructions for the assignment, and explain any requirements you have, before the user is presented with the upload form.

The assignments section of the page will contain:

an upload form (browse for a file on their device & upload it)
a list of all uploaded assignments
the assignment』s status (approved or not)
the points awarded for each assignment (optional; shown if enabled)
the ability to download previously uploaded assignments
the ability to upload additional assignments (only up to the number you specify)
the ability to delete assignments (only if they have not been approved yet)

Additional Settings
File extensions
You can specify exactly which file types may be uploaded.
If you leave this field blank, all default WordPress allowed file types will be accepted. To allow only certain file types:

Enter each allowed file type in the box (without the leading .)
Separate multiple file types with a comma
Capitalization doesn』t affect the files allowed to be uploaded, but capitalization is reflected to the user on the front-end

Your specified file type(s) will be listed to the user in the assignment upload area.

For example, enter the following to allow only Microsoft Word, Excel & PowerPoint files:

doc, docx, xls, xlsx, ppt, pptx

Here』s a list of common file extensions »
File size limit
In addition to the type of file, you can also specify the maximum file size allowed to be uploaded.

Enter a number, followed by M (for megabytes)

For example, to limit uploads to 5 megabytes, enter 5M.
Your specified file size limit will be displayed to the user in the assignment upload area.
NOTE
Your web host also sets a maximum file size limit. The lower limit will always be used. If you』re having trouble receiving assignment uploads, you can contact your host and ask them to increase your maximum file upload size.
Points
Points are an optional way to grade, or gamify, your assignments. You can set the total available points a user can receive, and then choose to either:

manually approve the assignment and enter a specific amount of points, or
automatically approve the assignment as soon as it』s uploaded, and award the total available points

If you』d like to award points to a user when they submit an assignment:

Next to Points, turn the setting on
Enter the total number of possible points that can be earned for a submitted assignment

Grading Type
There are two options for how assignments are graded:

Auto-approve (default)
No grading or approval is needed. The assignment will be automatically approved & full points will be awarded.
Manually approve
An admin or group leader must approve the assignment. The lesson cannot be completed until the assignment is approved.

If you choose to manually approve an assignment, you have additional options:
Limit number of uploaded assignments
By default, a user can upload an unlimited number of files. Enter a number in the box to specify the maximum number of files a user can upload for this assignment.

Leave blank for unlimited (default)

Once this limit is reached, the upload form will be removed and the user cannot upload any more files.
Allow file deletion
Enable this option to allow the user to delete their own uploaded files. The user will be presented with a delete icon next to the assignment.

This is only possible up until the assignment has been approved
Clicking that icon will instantly & permanently delete the file

Was this article helpful to you?

Yes

No

Quiz Custom Fields

In addition to adding an unlimited number of quiz questions, you can also collect custom data from a user before or after he/she takes a quiz. This article will explain how to set up quiz custom fields and where to view them.
NOTE
Quiz custom fields are set on a quiz-by-quiz basis. They cannot be set globally.
Table of Contents [show]1 Enable Custom Fields2 Display Position3 Custom Fields Setup4 Custom Fields Data Storage4.1 Was this article helpful to you?
Enable Custom Fields

Navigate to LEARNDASH LMS > QUIZZES
Click on the quiz you』d like to edit
Click on the Settings tab
Scroll down to the Administrative and Data Handling Settings section
Turn on the setting next to Custom Fields

Display Position
There are two places you can ask users to fill out your custom fields:

On the quiz startpage: Custom fields are displayed after any content you add to the top of the Quiz page, and immediately before the 「Start Quiz」 button.

NOTE
If you choose this option, the 「Autostart」 setting in your quiz display settings is ignored, and a 「Start Quiz」 button will always be displayed.

At the end of the quiz (before the quiz result): Custom fields are displayed immediately before the 「Finish Quiz」 button.

Custom Fields Setup

Add Field: To add custom fields, click the + Add field link
Field Name: Give your field a name. This will serve as the label for the form field.
Field Type: Choose a field type. The following options are available:

Text: A simple, one-line text field
Textarea: A longer, multi-line text area
Checkbox: Multiple options may be selected
Drop-Down Menu: Only one option may be selected from a drop-down menu
Radio: Only one option may be selected
Number: Similar to a 「Text」 field, but only allows numbers
Email: Similar to a 「Text」 field, but requires a valid email address
Yes/No: Similar to a 「Radio」 field, but only allows either a 「Yes」 or 「No」 value to be selected
Date: 3 drop-down menus will be displayed, one each for month, day & year

Edit list: For drop-down menus, radios & checkboxes, click the 「Edit list」 link to add options

Required: Enable the toggle if you』d like to make this field required. A value must be entered or selected before continuing on with the quiz.
Move Field: To move a field, hover over the 6 dots to the left of the field name, click, hold down your mouse, and drag it to a new location
Delete Field: Hover over the field』s row, and click the red 「Remove」 link

Custom Fields Data Storage
Quiz custom fields are stored along with quiz statistics. The most common places to view quiz statistics are:

when using the LearnDash Profile block/shortcode
in the WordPress admin, from the user』s profile

Click the 「Statistics」 link or icon in either place, and the custom fields will be displayed along with the rest of the quiz statistics.
NOTE
The Quiz Statistics option must be turned ON in order for data to be gathered.

Was this article helpful to you?

Yes

No

User Profiles

Creating a profile or account page for your users gives them an easy way to access important features of any LMS:

view all enrolled courses
edit their profile information
jump back into a course where they left off
view awarded points & quiz grades
access any certificates they have earned

LearnDash does not automatically generate a page to display a user』s profile or course information, but there are several tools you can use to build your own custom profile page. We』ll talk about the main LearnDash Profile block/shortcode, some options if you』re using third-party plugins that collect user information, and a few other tips for building a user profile with LearnDash.
Table of Contents [show]1 LearnDash Profile Block/Shortcode1.1 How to Use It1.2 LearnDash 3.0 Template1.3 LearnDash Legacy Template2 Display Enrolled Courses in a Grid3 Uncanny Toolkit Course Dashboard4 Resume Where You Left Off5 List of All Certificates6 WooCommerce Account Page6.1 Custom Endpoint7 Other Options7.1 Course Points8 LearnDash User Profiles Webinar8.1 Was this article helpful to you?
LearnDash Profile Block/Shortcode
The most commonly used solution for creating a LearnDash profile is to use the block (or shortcode) that comes with LearnDash. No additional plugins are required. You simply create a page on your site, and then insert the block/shortcode where you want the profile information to appear.
How to Use It
To use the LearnDash Profile block:

Create a new page in WordPress
Click the + icon to add a new block
Search for 「LearnDash Profile」
Select the 「LearnDash Profile」 block

To use the LearnDash Profile shortcode, simply use this shortcode:
[ld_profile]
For a full list of available options, please see the LearnDash Profile section in our blocks/shortcodes documentation.
LearnDash 3.0 Template
If you』re using LearnDash 3.0+, and have the 「LearnDash 3.0」 template enabled (check settings here), the LearnDash Profile will display the following information:

Avatar (profile image)
Name
Link to edit profile
Total number of courses enrolled in, courses completed, certificates awarded & points earned
List of registered courses, which includes:

ability to search courses
course progress indicators
links to download certificates
quizzes taken, along with date, scores & statistics

LearnDash Legacy Template
If you』re using the 「LearnDash Legacy」 template, your profile will look different, and include the following information:

Avatar (profile image)
Name, Username, Email
Course Points
Link to edit profile
List of registered courses, which includes:

course progress indicators
links to download certificates
quizzes taken, along with date, scores & statistics

Display Enrolled Courses in a Grid
The LearnDash Profile will display all courses in which the user is enrolled. This might be all you need, but you can also use the Course Grid add-on to show enrolled courses in a grid.
First, make sure the Course Grid add-on is installed & activated. Then, if you』re using the latest WordPress editor:

Insert the 「LearnDash Course List」 block
Set the 「My Courses」 option to 「Show Enrolled Courses only」

We also recommend enabling the option to 「Show Progress Bar,」 as this will display the user』s progress in each course.
If you』re using a page builder, or just prefer to use the shortcode, use the following shortcode to output a user』s enrolled courses, with a progress bar:
[ld_course_list mycourses="true" progress_bar="true"]
There are several other options you can use to customize the grid. Please see the Course Grid documentation for full details.
Uncanny Toolkit Course Dashboard
NOTE
This is a third-party add-on that requires the Uncanny LearnDash Toolkit Pro plugin.
With the Uncanny Toolkit Pro, you can use the [uo_dashboard] shortcode to insert a modified version of the [ld_profile] shortcode. It displays similar information, but there are a few key differences. The Course Dashboard:

does not display the user』s profile information (avatar, name, email, etc.)
also displays lessons & topics within each course (which the LearnDash Profile does not)

You can still expand/collapse each course, quickly view overall course progress, view quiz information, certificates, etc. Here』s what the Toolkit』s Course Dashboard looks like:

The Uncanny Toolkit Course Dashboard is also available as a Gutenberg block. There are some additional options you can set, as well. Please see Uncanny Owl』s full documentation.
Resume Where You Left Off
Another really helpful tool for LearnDash users is the ability to jump right back to the previous course, lesson or topic that they last worked on. The free version of the Uncanny LearnDash Toolkit provides this feature with their 「Resume Button」 module. When used on a custom profile page, it simply inserts a button that links to the most recently viewed course, lesson or topic for that specific user.
To use this feature:

Install & activate the free Uncanny LearnDash Toolkit plugin
Navigate to UNCANNY TOOLKIT > MODULES
Enable the 「Resume Button」 module
Add the following shortcode to your profile page, a sidebar, or a page builder, where you want the button to appear

[uo_learndash_resume]
The button defaults to say 「RESUME,」 but you can customize this text. You also have the option to display the title of the course, lesson or topic that the button is linking to.
The Uncanny Toolkit Resume Button is also available as a Gutenberg block.
List of All Certificates
Another helpful shortcode provided by the free Uncanny LearnDash Toolkit plugin is the ability to list all certificates earned by the user. Follow the same instructions above to install the plugin & enable the 「List Certificates」 module, then use this shortcode to display a user』s earned certificates:
[uo_learndash_certificates]
The Uncanny Toolkit List Certificates module is also available as a Gutenberg block. A few additional options are detailed in Uncanny Owl』s documentation.
WooCommerce Account Page
Many LearnDash users choose WooCommerce as an ecommerce platform to sell their courses (see our integration guide). WooCommerce creates its own account area, complete with account details (name, email, etc.), address information, order history, etc. You can tap into this to include a list of enrolled courses.
Example of the WooCommerce 「My Account」 page with a LearnDash Profile (Storefront theme)
If you』re already using WooCommerce, or you』ve gone through the setup wizard, a 「My Account」 page should have already been created for you. If not…

Create a new page in WordPress
Insert this shortcode

[woocommerce_my_account]
NOTE
The design of your WooCommerce 「My Account」 page is heavily dependent on your WordPress theme. If your theme doesn』t offer great support for WooCommerce, you might want to check with your theme developer, or possibly hire someone to help with the design.
On this same page, you can insert any of the tools we highlighted above (LearnDash Profile, Resume Button, List of Certificates, etc.). Whatever you insert onto this page will be displayed on all WooCommerce account sub-pages (dashboard, orders, addresses, account details, etc.). This might not be ideal, in which case you can explore the next section.

WARNING
By default, WooCommerce blocks non-admin users from entering WP Admin, or seeing the WP Admin bar. This includes the WP Profile.
Click here for a workaround.
Custom Endpoint
NOTE
Development experience is highly recommended.
The 「My Account」 section of WooCommerce operates on what are called 「endpoints.」 Each endpoint is essentially another page within the My Account section of your website. Endpoints represent the part of the URL that follows your /my-account/ page. A few examples of built-in WooCommerce endpoints for the My Account area include:

Orders – /my-account/orders/
Addresses – /my-account/addresses/
Edit Account – /my-account/edit-account/

WooCommerce provides the ability for anyone to create their own endpoint. The most obvious way to integrate this with LearnDash would be to create an endpoint for courses. Your endpoint could look something like this:

Courses – /my-account/courses/

On this new endpoint, you could then insert any type of profile/course information that we highlighted above. This would allow your user』s course information to have it』s own page and URL. You have complete freedom over the type of endpoint(s) you create, and can insert any type of content you』d like.
View WooCommerce』s documentation on endpoints and/or search the web for how to create a custom endpoint.
Other Options
Course Points
If you』re using LearnDash』s built-in points system, you could use the [ld_user_course_points] shortcode (or block) to insert the user』s total points onto a custom profile page. That would output this:
Earned Course Points: 100
LearnDash User Profiles Webinar
Check out our latest webinar about setting up, building and customizing your user profiles with LearnDash, along with other tips and tricks on how to make it easier for you and your users to update and manage your user profiles.

Was this article helpful to you?

Yes

No

Widgets

Similar to blocks & shortcodes, LearnDash widgets provide another way to add dynamic content to your LearnDash site. This article will explain the various ways you can insert widgets, as well as what each LearnDash widget displays.
Table of Contents [show]1 How to Insert LearnDash Widgets1.1 The Customizer1.2 Appearance > Widgets1.3 Page Builders2 Course Navigation3 Course Progress Bar4 User Status5 Course Information6 Course7 Lesson8 Quiz9 Additional Resources9.1 Was this article helpful to you?
How to Insert LearnDash Widgets
In WordPress, there are a few ways to add widgets to your site. While LearnDash provides several widgets for you to use, please keep in mind that your theme determines WHERE they can be inserted.
In the following examples, your WordPress admin screens might look slightly different, depending on which theme you』re using, and the widgetized areas they have made available to you.
The Customizer
The WordPress Customizer is the preferred way to add LearnDash widgets to your site. You』ll be able to see a preview of the widgets before you make them live.

Navigate to APPEARANCE > CUSTOMIZE
Click the Widgets panel
Click on the name of the widgetized area in which you』d like to add a widget
Click the + Add a Widget button
Search for a widget (try 「LearnDash」 or 「course」 to easily find LearnDash widgets)
Click on the widget you』d like to add
Add a title and/or set widget options
Be sure to click Publish at the top when you』re finished

Appearance > Widgets
The other way to add widgets is directly from the widgets screen. You won』t see a preview of your widgets this way, but all the same widgets are available to you, and they have the same options.

Navigate to APPEARANCE > WIDGETS
Locate the widgetized area in which you』d like to add a widget
Then look for the widget you want to add
Click, hold & drag the widget inside the widgetized area
Add a title and/or set widget options
Click the Save button at the bottom

Page Builders
LearnDash widgets shown in the Elementor page builder
Some page builders also make WordPress widgets available to use within the page building interface, and this includes all LearnDash widgets. The free version of Elementor is one such example, but there could be others. Check with your page builder』s documentation to see if they allow you to insert WordPress widgets.
DEVELOPERS
You can also add widgets directly to theme/template files using the_widget() function.

The remainder of this article will discuss each LearnDash widget, what information it displays, and its optional settings.
Course Navigation

The Course Navigation widget automatically detects which course is currently being viewed, and it displays all the sections, lessons, topics & quizzes associated with that course, along with status indicators for the current user.
By default, topics are hidden within an expandable container, but can be revealed for each lesson, or globally using the 「Expand All」 link at the top.
The Course Navigation widget displays:

Link to go back to the course page
「Expand All」 link that reveals all topics & quizzes
All sections, lessons, topics & quizzes related to the current course being viewed
The number of topics and/or quizzes within a lesson
Status indicators for whether or not a course step has been completed

The following options are available:

Show/Hide course quizzes
Show/Hide lesson quizzes
Show/Hide topic quizzes

NOTE
This widget will only appear on course, lesson, topic & quiz pages.
Course Progress Bar

The Course Progress Bar widget displays three pieces of information, all related to the current user, and the current course being viewed (which is automatically detected by LearnDash).

A horizontal progress bar, indicating the user』s progress in the course
The percentage of the course that has been completed thus far
The date of the user』s last activity

NOTE
This widget will only appear on course, lesson, topic & quiz pages.
User Status
NOTE
This widget was introduced in LearnDash 3.0, and requires the 「LearnDash 3.0」 theme. It is not available when using the 「Legacy」 theme. Learn more about LearnDash 3.0 vs. Legacy.

The User Status widget displays the following information:

The courses in which the user is registered
A status indicator for each course, along with completion percentage & number of steps completed
The user』s enrollment date, if applicable

The following options are available:

Number of courses shown per page (before pagination appears)
Course order & order by options

NOTE
This widget is only displayed to logged-in users.
Course Information
The Course Information widget displays the following information:

The courses in which the user is registered
Course progress details (not started, in progress, completed, as well as number of steps completed)
Quiz information (quiz title, status, score, points awarded, date taken
A list of the quizzes the user has taken

The following options are available:

Show/Hide course thumbnail
Number of courses shown per page (before pagination appears)
Course order & order by options
Number of courses shown per page, in the progress details section
Course order & order by options for progress details section
Number of quizzes shown per page (before pagination appears)
Quiz order & order by options

NOTE
This widget is only displayed to logged-in users.
Course
The Course widget simply displays a list of all the courses on your site. Only the course title is displayed, and there are no additional options. The list will be shown on every page, to all users, regardless of whether or not they are logged into the site.
Lesson
The Lesson widget simply displays a list of all the lessons for the current course that is being viewed. Only the lesson title is displayed (no status indicators), and there are no additional options. This list is only shown on course, lesson, topic & quiz pages, and will automatically detect the current course being viewed.
Quiz
The Quiz widget simply displays a list of all the quizzes on your site, regardless of whether they are assigned to a course, lesson or topic. Only the quiz title is displayed, and there are no additional options. The list will be shown on every page, to all users, regardless of whether or not they are logged-in.

Additional Resources
In addition to using widgets in the ways above, here are a few additional things you can try:

Convert widgets into shortcodes using the AMR Shortcode Any Widget plugin
Create new widgetized areas for your theme using the Content Aware Sidebars plugin
Customize your widget logic, design, visibility & more using the Widget Options plugin

Was this article helpful to you?

Yes

No

Assignments

Assignments allow your users to upload files to any lesson or topic of your choosing. They are completely optional, but provide a more in-depth way for you to check-in on a user』s comprehension of the learning material.

Global Settings
Applied to all assignments throughout your entire site
Enable Assignment Uploads
Walks you through all the available options when setting up assignments
Manage Assignments
View, search, filter, approve, delete, comment, assign points & get notified

Assignments are designed for file uploads. For other ways to measure a user』s understanding of course material, consider using one of several question types available in quizzes.

Was this article helpful to you?

Yes

No

Recommended Hosting

If you have not yet selected a host for your LearnDash site, or you are not happy with the performance of your current host, then read the article below:
Popular Hosts for LearnDash

Was this article helpful to you?

Yes

No

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:

Navigate to LEARNDASH LMS > QUIZZES
Click the Settings tab

Table of Contents [show]1 Global Quiz Management & Display Settings1.1 Quiz Builder1.2 Custom Quiz Time Formats1.3 Quiz Template Management2 Quiz Email Settings3 Quiz Taxonomies (Categories & Tags)3.1 Managing Categories & Tags4 Quiz Custom Post Types4.1 Was this article helpful to you?
Global 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.

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

Quiz Email Settings

Please see our full documentation on quiz email notifications →
Quiz Taxonomies (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:

Navigate to LEARNDASH LMS > QUIZZES
Select the Actions dropdown menu
Select your desired menu option

Quiz Custom Post Types

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

Was this article helpful to you?

Yes

No

Login & Registration

Login & registration is a crucial part of any online learning platform. While LearnDash does allow you to offer free courses to the public (see course access levels), a majority of course administrators require a user to be registered, or pay, before taking a course.

LearnDash Built-In Login & Registration
Use our built-in login & registration features. No additional plugins needed.

As of version 3.0, LearnDash has a built-in login & registration form you can use. In addition, you can use just about any WordPress plugin that provides WordPress login and/or user registration functionality. This includes:

ecommerce plugins (WooCommerce, Easy Digital Downloads)
membership plugins (MemberPress, Paid Memberships Pro, Memberium)
form plugins (Gravity Forms)
…and others

It』s also possible to use the default WordPress login & registration process. Please reference the WordPress documentation for more on how to use this login method.
Setting Up WordPress User Registration
In this webinar we will show you how to easily configure a better experience for your students. Whether you are using LearnDash or not, these tips will help you get your WordPress user registration just right!

If you are looking into customizing your User Registration process even further (i.e. making it more aesthetically pleasing, leveraging sign-ups for success, and even going as far as changing and updating your email notification options) here is a follow-up webinar that talks about Advanced User Registration with LearnDash.

Was this article helpful to you?

Yes

No