Translation

Translation

LearnDash is in English and has user-donated translations. Strings in the LearnDash codebase are translatable.
You can use free software like poEdit to create and modify LearnDash translation files for your language. Or a free WordPress plugin like Loco Translate.
Table of Contents [show]1 Current Translations2 Adding (or Modifying) a Translation3 Common Issues3.1 Not Updating from Latest POT File3.2 Translations Set to 「Needs Work」3.3 Unexpected Locale3.4 Incorrect Folder3.5 Incorrect File Name3.6 Not Accounting for All Contexts3.7 Not Considering Strings from Third-Party Code3.8 Was this article helpful to you?
Current Translations
NOTE
As the translations are user-donated, they may not be 100% complete for your desired language.

Arabic (ar)
Chinese (zh_CN)
Danish (da_DK)
Dutch / Nederland (nl_NL)
French (Canada) (fr_CA)
French (France) (fr_FR)
German (de_DE)
Hebrew (he_IL)
Italian (it_IT)
Polish (pl_PL)
Portuguese (Brazil) (pt_BR)
Russian (ru_RU)
Spanish (Spain) (es_ES)
Swedish (sv_SE)

Right-to-left (RTL) languages are supported.
Adding (or Modifying) a Translation
If you are creating a new translation, you can reference this helpful list of WP Locale Codes for file naming conventions.
​If you need to update a translation, you can do so by following these steps:

​Navigate to LEARNDASH LMS > SETTINGS > TRANSLATIONS
Download the latest POT file by clicking the POT download button (it will automatically download)
Download the .po file by clicking the PO download button (it will open in a new tab)
Right click & save the file
Open the .po file with PoEdit
Navigate to CATALOG > UPDATE FROM POT and select the downloaded POT file in step 2
Make your additions and/or modifications to the translation file
Save the .po file
Regenerate the new .mo file via FILE > COMPILE TO MO
Using an FTP program or File Manager, add your new .mo and .po files to the /wp-content/languages/plugins/ folder

NOTE
Verify that the file is named correctly and in the proper directory. If one or both of these is incorrect then you will encounter issues.

Common Issues
Not Updating from Latest POT File
If you are translating strings such as 「Next Lesson」 and noticing that the translation is not reflected on your site, then that is because you are translating from an out of date POT file.
The string in the codebase of LearnDash is actually 「Next %s」 because the %s acts as a placeholder for your Custom Label (even if you do not use Custom Labels).

This may also be why you notice that all of a sudden you have 「lost」 translations of strings like 「Next Lesson」 and 「Previous Course」 and other strings that contain a custom label. However, the translation is not necessarily lost. It is no longer used because the codebase is now using placeholders in those strings, not the literal words such as Lesson or Course.
To resolve, download the latest POT (step #2), then follow steps 6-10 to update from the latest POT, add translations for the new strings as needed, and upload your new .mo/.po files to the right place.
Translations Set to 「Needs Work」
Be mindful of 「Needs Work」 settings on individual translations. This is typically indicated by an orange color, and an orange toggle after selecting the individual translation in poEdit.

When 「Needs Work」 is set on a translation, you are telling WordPress that you are not sure that this is the correct translation. Therefore, WordPress does not display this translation on your site because it thinks the translation 「Needs Work」 as per your instructions.
To resolve, toggle the 「Needs Work」 setting to off. It should look like similar to the screenshot below.

Then, save your new .mo/.po files and upload as per step 10 in the above documentation.
Unexpected Locale
WordPress translations may be localized to a particular region. For example, es_ES would be Spanish in Spain, and es_MX would be Spanish in Mexico.
As far as WordPress is concerned, these are totally different languages (technically, referred to as 「localizations」).
If your WordPress site localization is set to es_MX, then that setting will not pull any information from your es_ES translation files (even though to you, the differences in language may be minor).
Incorrect Folder
Please ensure your LearnDash translation files are in the folder path below, with the file names that include locale code. For example:

/wp-content/languages/plugins/learndash-es_ES.po
/wp-content/languages/plugins/learndash-es_ES.mo

It is not a good idea to store your customized translation files inside directories such as /wp-content/plugins/sfwd-lms/languages/ due to risk of overwrite in the event of a plugin update.
Incorrect File Name
This section is to highlight the correct file name format, already seen in the above 「Incorrect Folder」 issue.
learndash[hyphen][locale code, underscores used as separators].po
Please ensure your hyphens and underscores are in the right places. This is correct:

learndash-es_ES.po

These are not:

learndash_es_ES.po (underscore instead of hyphen is incorrectly placed between learndash and es_ES).
learndash-es-ES.po (hyphen instead of underscore is incorrectly placed between es and ES).

The .po and .mo files should be identically named, except for the file extension.
Not Accounting for All Contexts
Translating a word once does not necessarily change the word in all strings in which that word occurs.
Words used in different contexts may be the same in your language. For example, 「quiz」 may serve as both a verb and a noun in English.
Understand that other languages may use different words depending on the context, and your translation files will need to account for that on a string-by-string basis.
PoEdit and Loco Translate both have search features to ensure you are accounting for every instance of a word in the translation files.
Not Considering Strings from Third-Party Code
Not every translatable string seen on a LearnDash-related page, such as a page that contains what appears to be a Course Grid or Login Form, is from the LearnDash codebase. Therefore, you may not be able to find the word you need to translate in the LearnDash file source text.
Or maybe you do, however the string output is coincidentally duplicated in third-party code where it is actually being output.
This is especially common with WordPress themes built with LearnDash in mind, such as BuddyBoss, that override template files (or other third-party addons for LearnDash).
For example, the LearnDash source text includes the string 「Incorrect username or password. Please try again」
You change that string in your LearnDash .po file, but notice it is not reflected on your site. Other parts of your LearnDash translation are working as intended.
This may be because the string is actually output by third-party code, and is coincidentally using the same string. You would need to translate it separately.

Was this article helpful to you?

Yes

No

Group Administration

Group Administration

When a user has been designated as a Group Leader, they gain access to LearnDash Group Administration capabilities. This gives the Group Leader the ability to run reports and communicate with the users in their group(s).
Table of Contents [show]1 Accessing Group Administration1.1 Assignments1.2 Submitted Essays1.3 Group Administration1.3.1 View Group Users1.3.2 Email Group Users1.3.3 Export Group Data2 FAQ2.1 Was this article helpful to you?
Accessing Group Administration
Group Leaders access Group Administration capabilities when they log into their account. Upon logging in, Group Leaders will see a LearnDash LMS menu with the following sub-menus available:

Assignments
Submitted Essays
Group Administration

NOTE
Please see the User Groups documentation for information on how to make a user a Group Leader.
Assignments
When any user who is a member of a Group Leader』s group(s) submits an assignment, it is listed under the Assignments menu for review and approval (if necessary).
Manage Assignments documentation »
Submitted Essays
Just like assignments, when any user who is a member of the Group Leader』s group(s) completes an essay question in a quiz, it is listed under the Submitted Essays menu for review and approval (if necessary).
Manage Essays documentation »
Group Administration
The Group Administration menu is where a Group Leader has the ability to:

View group users
Email group users
Export group data

View Group Users
By clicking on List Users from the Group Administration menu, Group Leaders can view details for anyone that they manage. This page includes the following fields:

Username
Name
Email
Actions (Report)

The Report link takes Group Leaders to another page where they can view the total group points of the selected user and optionally award extra course points.

Email Group Users
Group Leaders have the ability to email everyone in a group that they manage. To do this:

Navigate to LEARNDASH LMS > GROUP ADMINISTRATION
Click on List Users
Click the Email Group button above the table of users
Enter an Email Subject
Compose an Email Message
Click Send

Export Group Data
There are two reports that can be exported to .csv format by navigating to LEARNDASH LMS > GROUP ADMINISTRATION

Course Data (by clicking the Export Progress link) displays all user』s course progress, what lesson they are currently on, and if the course has been marked complete
Quiz Data (by clicking the Export Results link) displays all user』s quiz scores, when the quiz was taken, and if the quiz was successfully passed

FAQ
Is it possible to give Group Leaders more capabilities?
Yes. You can extend the capabilities and permissions of the Group Leader user role by using a plugin like User Role Editor.
Why aren』t emails sent to the group being delivered?
By default, emails sent using the Group Email feature are sent by your web host. While sending email is possible in this manner, it might not be ideal for your situation. See these instructions for other email delivering options.
Can Group Administration be on the front-end of my website instead of in the WordPress admin area?
No. This is not currently an option.

Was this article helpful to you?

Yes

No

Manage & Grade Essays

Manage & Grade Essays

This article will show you how to manage, grade, download & comment on submitted essays. To learn more about setting up essays within a quiz, please read our article on the essay question type.
Table of Contents [show]1 Accessing Submitted Essays2 Filter Essays3 Grading & Awarding Points3.1 From the Listing Screen3.2 Individual Essay4 Download an Essay File5 Commenting on Essays5.1 Was this article helpful to you?
Accessing Submitted Essays

Navigate to LEARNDASH LMS > QUIZZES
Click on the Submitted Essays tab

This page will list all essays that have been submitted by all users, for all quizzes.
Filter Essays
You can filter the Submitted Essays list in a few ways:

Choose between Graded & Not Graded (shown in pink)
Filter by the course, lesson or quiz that the essay is associated with (shown in blue)

Choose option(s) from the dropdown menus
Click the Filter button

Grading & Awarding Points
There are two ways to grade essays & award points.
From the Listing Screen
This is the quick & easy way to grade an essay.

From the Submitted Essays listing screen…
Enter the number of points you』d like to award
Click the approve button

The page will reload and you』ll see the status change from 「Not Graded」 to 「Graded,」 and the appropriate points will be displayed.
No further adjustments can be made from the listing screen, but you can open each individual essay if you need to make any changes.
Individual Essay
This method is a little more time intensive, but provides more flexibility. You can change an essay from 「Graded」 to 「Not Graded,」 as well as adjust the points awarded.

From the Submitted Essays listing screen…
Click on an essay title to edit it
Find the Essay Grading Status section in the sidebar
Update the essay status (Graded or Not Graded)
Update the points awarded
Click the Update button to save your changes

If you previously set the grading of the essay to Not Graded, No Points Awarded, then the status and grade of the quiz will no longer be in Pending status after you award points and indicate that the essay is graded.
If the user did not meet the passing threshold prior to grading, but after the grading of the essay they meet the threshold, then they will be permitted to continue with the course.
Download an Essay File
If you chose the 「Upload」 essay type, your submitted essay will include the file that the user uploaded.

From the individual essay screen…
Scroll down to the Essay Upload section
Click on the file to download it

Commenting on Essays
By default, all submitted essays actually have their own page. You can access that page by clicking on the permalink at the top of the individual essay screen in the WordPress admin.

As an admin, if you』d like to leave a comment for the user:

Make sure 「Allow comments」 is checked in the Discussion section
In the Comments section, click the 「Add comment」 button
Type your comment
Click the 「Add Comment」 button to save your comment

Your comment will now appear on the essay page mentioned above.
NOTE
The design & layout of the essay page is managed by your WordPress theme.

Was this article helpful to you?

Yes

No

Page Builders + LearnDash

Page Builders + LearnDash

One of the most common set of questions our support team gets asked is how LearnDash works with page builders.

Which page builder plugins are compatible with LearnDash?
What』s the best page builder to use?
How do I customize the layout of my LearnDash courses, lessons & topics with a page builder?
Can I use a free page builder or do I need the pro version?

In this comprehensive guide, we』ll answer all of those questions, as well as walk you through exactly how to use specific page builders to best design your LearnDash courses. We』ll focus on three of the most popular WordPress page builders:

Elementor
Beaver Builder
Divi

Before we dive into the specifics of each, it』s important to understand what a page builder can & cannot do. We』ll also cover some basics that apply to how all page builders interface with LearnDash, no matter which one you choose to use.
NOTE
This guide assumes you are using the LearnDash 3.0 active template. With the exception of Elementor (which requires LearnDash 3.0), most of the concepts also apply to the Legacy template, but there could be some inconsistencies. We』ll also be using the new WordPress editor (aka: Gutenberg). Screenshots will look different if you』re using the Classic Editor plugin.
Table of Contents [show]1 How Page Builders Work2 How LearnDash Adds Content to the Page2.1 Dynamic Content2.2 Your Own Course, Lesson, Topic & Quiz Content2.3 LearnDash Blocks2.4 LearnDash Shortcodes2.5 LearnDash Widgets2.6 An Exception: Focus Mode2.7 Summary3 Choosing a Theme3.1 General Page Layout4 Enable Page Builder for LearnDash Post Types4.1 Elementor4.2 Beaver Builder4.3 Divi5 Using Shortcodes with Page Builders5.1 Elementor5.2 Beaver Builder5.3 Divi6 Using Widgets with Page Builders6.1 Elementor6.2 Beaver Builder7 Basic Content Editing with Page Builders7.1 Conditionally Show/Hide Content7.1.1 Elementor Example7.1.2 Beaver Builder Example7.1.3 Divi Example8 FAQ8.1 Was this article helpful to you?
How Page Builders Work
An entire book could be written on this topic, but that』s obviously not the focus of this article. However, there are a few basic things you should understand about how page builders work.

Almost all page builders let you design the main content of a page, post, course, lesson or other custom post type. Essentially, the same content that you would add via the default WordPress editor. This does not include your site』s header, sidebars or footer.
Most pro versions or premium page builders do let you design your site』s header, sidebars and footer. (Elementor Pro』s Theme Builder, Beaver Themer, etc.)
All page builders come with their own set of elements that you can use to design & lay out your content (columns, headings, lists, tables, icons, photo galleries, etc.).

These differ depending on the page builder you』re using, as well as the free vs pro version of that particular builder.

Keeping in mind the type of content a page builder has control over, let』s talk about how LearnDash content is added to your site』s pages.
How LearnDash Adds Content to the Page
There are several ways LearnDash content gets added to a page. The differences are important to understand, as they directly apply to whether or not they can be controlled or modified via a page builder.
Dynamic Content
Dynamic content refers to content that you, the site owner, does not directly add in the WordPress editor. Based on the type of page that a user is viewing (course vs. lesson vs. topic), as well as how that course is configured, LearnDash automatically adds content to the page.
Examples of dynamically added LearnDash content include, but are not limited to:

On a course page: For non-enrolled users, the current status, price & get started sections at the top. For enrolled users, the date of last activity, progress bar & status indicator.
On a course page: The course content list at the bottom, which contains all lessons, topics & quizzes assigned to that course
On a lesson page: The list of topics assigned to that lesson
On lesson/topic pages: The assignments area, which provides a way for the user to upload assignments, and lists all uploaded assignments
In Focus Mode: The header, which includes a logo (optional), course progress, navigation buttons, and an avatar w/ dropdown menu
In Focus Mode: The sidebar, which contains the course title and navigation links

✅ You CAN edit LearnDash dynamic content with Elementor (using our compatibility integration)
❌ You cannot edit LearnDash dynamic content with Divi
❌ You cannot edit LearnDash dynamic content with  BeaverBuilder
DEVELOPERS
If you』re comfortable with HTML & PHP, you can override LearnDash template files. This allows you to customize the dynamic content, as well as change where on the page it gets inserted. Technical experience required.
Your Own Course, Lesson, Topic & Quiz Content
This refers to the content which you, the site owner, have direct control over. For all course, lesson, topic & quiz pages, you can freely add & edit whatever content you』d like.
✅ If you』re using a page builder, you can design this content with your page builder of choice.
However, LearnDash determines where on the page it will go.

For example, on a lesson page (using Focus Mode), your own content will always be placed after the breadcrumbs and before the next & previous lesson buttons. If you』ve added materials to the lesson, two tabs will be inserted dynamically:

Lesson
Materials

Your own lesson content will be added directly below the 「Lesson」 tab.
Keep in mind, only your own content, added in this specific area, can be edited with a page builder. All other page elements in Focus Mode are controlled solely by LearnDash (or by using one of two popular third-party LearnDash design plugins, Design Upgrade Pro or Visual Customizer).
LearnDash Blocks
LearnDash blocks provide a way for you to add specific LearnDash information to the main content area of a page, but only if you』re using the latest version of the WordPress editor (aka: Gutenberg). Blocks only work within Gutenberg.

A few examples of LearnDash blocks include:

LearnDash Profile: displays a user』s profile & registered courses
LearnDash Course List: displays a list of courses, or a grid if using the Course Grid add-on
LearnDash Course Progress: displays a progress bar showing the user』s progress in that course

❌ When using a page builder, there is no way to add a LearnDash block to your page.
LearnDash Shortcodes
Every LearnDash block has an accompanying shortcode. A shortcode is a simple piece of text that outputs specific LearnDash information. Many shortcodes come with parameters (or options) that let you customize which information is displayed. See our complete guide on LearnDash shortcodes.
A shortcode looks like this:
[ld_profile]
This example outputs a user profile, complete with their profile image, name, some basic stats, and a list of courses they』re enrolled in, along with their progress in each.
✅ The big advantage of shortcodes over blocks is that they can be used with all page builders.
Exactly how to use LearnDash shortcodes depends on which page builder you are using, which we』ll go into more detail below.
LearnDash Widgets
Widgets are a core part of WordPress. They are pieces of functionality that can easily be added to any WordPress sidebar area. LearnDash provides a handful of widgets as well. LearnDash widgets provide the ability to add course navigation, course lists, and other various course elements. We have a complete guide on widgets here.
The following page builders allow the use of LearnDash widgets:
✅ Elementor: Free & Pro
✅ Beaver Builder: Free & Pro
❌ Divi: No (you can add entire sidebar areas but not individual widgets)
An Exception: Focus Mode
Focus Mode works a bit differently than the rest of the pages on your site. The same ideas for how content is added still apply, but when Focus Mode is enabled, your site』s normal header, sidebar & footer are removed.
❌ The header is dynamic content, not editable with a page builder
❌ The sidebar course navigation is dynamic content, not editable with a page builder
❌ The page title, progress meter & breadcrumbs are dynamic content, not editable with a page builder
✅ The lesson, topic & quiz content (below the breadcrumbs) is your own content, and this is editable by a page builder
Summary

Dynamically added by LearnDash is only editable with Elementor (using our compatibility add-on)
Focus Mode design elements cannot be edited with page builders
All content added by you, via the WordPress editor, is editable with page builders
When designing with a page builder, use LearnDash shortcodes & widgets (not blocks)

Choosing a Theme
If you want to use a page builder with LearnDash, the theme you choose will have some impact on how you can design your content. Just about all WordPress themes work with page builders (and with LearnDash), but some work better.
In general, themes that explicitly provide page builder support will give you more control over the design of your courses. A few popular themes that have been specifically designed for use with page builders are:

Astra
GeneratePress
OceanWP

You don』t have to use one of these themes. All WordPress themes (built to the proper standards) work with LearnDash. We just wanted to highlight the ones that give you the most flexibility.
General Page Layout
Using one of the aforementioned themes provides you with some advantages over other themes, particularly when it comes to using a page builder.
NOTE
These settings vary from theme to theme. Not all themes will have these options, but the themes mentioned above have some variation of them.

Content width: Multiple options are typically available for narrow, wide, full-width and/or 100% stretched
Sidebars: You can choose to enable/disable the sidebar on individual pages, or choose which side it should appear (right or left)
Disable page title: This allows you to hide the default page title that is included at the top of the page, and add your own using a page builder
Disable featured image: This allows you to hide the featured image that is usually displayed at the top of your course page

Here are a few examples:
Individual page settings using the free Astra theme
Individual page settings using the free GeneratePress theme
Individual page settings using the free OceanWP theme (requires the 「Ocean Extra」 plugin)
NOTE
If you want to control your layout & spacing completely with a page builder, you probably want to set your page settings to use no sidebar, and a content width of 「full」 or 「stretched.」

Before we get into specific examples with each page builder, let』s make sure your builder is enabled for use with LearnDash.
Enable Page Builder for LearnDash Post Types
Before you can use a page builder with LearnDash, you need to ensure that you』ve enabled the page builder to work with LearnDash custom post types. If you can』t find a way to edit a piece of LearnDash content using your page builder, try following these steps to enable it.
Elementor

Navigate to ELEMENTOR > SETTINGS
In the 「Post Types」 section, check the boxes for Courses, Lesson, Topics & Quizzes (or just select the ones you need)
Click 「Save Changes」

Now you will see the 「Edit with Elementor」 button on the post types you selected.

ELEMENTOR PRO
If you』re using Elementor Pro to build custom templates for LearnDash content, please see this article on how to get LearnDash post types to appear in the post type menu.
Beaver Builder

Navigate to SETTINGS > BEAVER BUILDER
Click on 「Post Types」
Check the boxes for Courses, Lesson, Topics & Quizzes (or just select the ones you need)
Click 「Save Post Types」

Divi
By default, Divi should be enabled for courses & lessons, but if you want to use it with topics and/or quizzes, you』ll need to enable it.

Navigate to DIVI > PLUGIN OPTIONS
Click on the 「Post Types Integration」 tab
Click the post types for Topics & Quizzes (or just select the ones you need)
Click 「Save Settings」

Using Shortcodes with Page Builders
Shortcodes are one of two ways you can add LearnDash-specific content using a page builder. Let』s go through exactly how to add use shortcodes in each page builder.
Elementor
When you go to edit a piece of LearnDash content (course, lesson, topic or quiz), you』ll have an 「Edit with Elementor」 button at the top. Click this button to open your content with Elementor.

If you haven』t added any of your own content to the page yet, you will see a pretty blank page. Your global header & footer should be there, but you won』t see any dynamic LearnDash content while the course is still a draft. Once you publish the course, the LearnDash dynamic content will appear in the preview screen.
Example of a LearnDash course page as you begin to edit it with Elementor
So keep in mind, what you are adding to the page with Elementor will show up in a particular area, along with the dynamic content that LearnDash adds.
To add a shortcode to your page with Elementor:

Locate the 「Shortcode」 widget in the left panel
Click, hold & drag the widget somewhere on the page
In the left panel, type any LearnDash shortcode
You might need to click the green 「Apply」 button to preview it
When you』re finished editing, be sure to click the 「Publish」 or 「Update」 button at the bottom

Use the full power of Elementor to add other widgets on the page (before or after LearnDash shortcodes)
Use Elementor』s columns to place LearnDash shortcodes next to other content
Get creative by adding backgrounds & other design options to the Section that contains your LearnDash shortcode
Add as many LearnDash shortcodes to a page as you』d like

Beaver Builder
When you go to edit a piece of LearnDash content, you』ll have a 「Launch Beaver Builder」 button where your content would normally appear. Click this button to open your content with Beaver Builder.

You won』t see any dynamically added LearnDash content in your preview until you publish the course. The content you add will be placed in-between LearnDash』s dynamic content.
To add a shortcode to your page with Beaver Builder:

Locate the 「HTML」 module in the left panel
Click, hold & drag the module somewhere on the page
In the left panel, type any LearnDash shortcode
Click the 「Save」 button at the bottom to preview it
When you』re finished editing, be sure to click the 「Done」 button in the top-right corner, and then either 「Publish」 or 「Update」 to save your changes

Divi
When you go to edit a piece of LearnDash content (course, lesson, topic or quiz), you』ll see a 「Use The Divi Builder」 button at the top. Click this button to open your content with Divi.

When you first launch Divi, you might be prompted with a few options:

Build from Scratch
Choose a Premade Layout
Clone Existing Page

Choose the option that best meets your needs. You will then be sent to Divi』s visual builder screen.
To add a shortcode to your page with Divi:

Click the green + icon to add a new row
Choose the the layout of your row
Then choose the 「Code」 module (the 「Text」 module will also work)
Type in any LearnDash shortcode
Click the green checkmark icon
When you』re finished editing, be sure to click the three dots at the bottom of the screen, and then the 「Save」 button

Using Widgets with Page Builders
In addition to shortcodes, widgets are another method of adding LearnDash content via a page builder. Let』s cover the specifics of each page builder that allows for the use of LearnDash widgets.
Elementor
In Elementor, the LearnDash widgets are located in the 「WordPress」 section in the left panel. You can also access them using the 「Search Widget…」 bar at the top. The following LearnDash widgets are available:

Course Progress Bar
Course Navigation
Course Information
User Status
Course
Lesson
Quiz
Certificates

To add a LearnDash widget to your page with Elementor:

Locate the widget you want to add from the left panel
Click, hold & drag the widget somewhere on the page
(optional) In the left panel, give your widget a title and adjust the available settings
You might need to click the green 「Apply」 button to preview it
When you』re finished editing, be sure to click the 「Publish」 or 「Update」 button at the bottom

Beaver Builder
The same widgets mentioned above (for Elementor) are also available for Beaver Builder.
To add a LearnDash widget to your page with Beaver Builder:

In the left panel, either switch your module group to 「WordPress Widgets」 or use the search feature

Locate the widget you want to add
Click, hold & drag the widget somewhere on the page
(optional) In the left panel, give your widget a title and adjust the available settings
When you』re finished editing, be sure to click the 「Done」 button in the top-right corner, and then either 「Publish」 or 「Update」 to save your changes.

Basic Content Editing with Page Builders
Now that you know how to add LearnDash shortcodes & widgets to your favorite page builder, let』s talk about a few basic editing rules that apply to all page builders when you』re working with LearnDash.
Conditionally Show/Hide Content
LearnDash provides a few shortcodes you can use to show content to a specific type of user:

[student] and [/student] – only visible to someone who is registered for the course
[visitor] and [/visitor] – only visible to someone who is not registered for the course

These can be especially useful for:

providing registered students with student-only content on the course page
displaying a sign-up/purchase message to non-registered users when they』re viewing sample lessons
…or any number of other creative applications

Unlike other LearnDash shortcodes, these cannot be used within a shortcode widget. They must be used within a text editor or HTML widget.

Elementor: Use the 「Text Editor」 or 「HTML」 widget
Beaver Builder: Use the 「Text Editor」 or 「HTML」 widget
Divi: Use the 「Text」 or 「Code」 widget

You can place any content you』d like between the shortcodes, just make sure it is all contained within the same element. You cannot have an opening [student] shortcode in one element, add some content in subsequent elements, and then place your closing [/student] shortcode in another element.
NOTE
If you』re using the free Uncanny LearnDash Toolkit, you can also use the [uo_show] shortcode to show content to logged in vs. logged out users (regardless of course enrollment status).
Elementor Example
We recommend using the 「Text Editor」 widget in Elementor
Beaver Builder Example
We recommend using the 「Text Editor」 module in Beaver Builder
Divi Example
We recommend using the 「Text」 module in Divi
FAQ
I』m using a page builder not mentioned in this article. Can I still use it with my LearnDash-powered site?
Yes. The same principles mentioned in this article apply to all WordPress page builders. The widgets & modules you use might be named differently, but the concepts are the same.

Was this article helpful to you?

Yes

No

Quiz Access & Progression

Quiz Access & Progression

This article will discuss the various ways you can prevent user access to a quiz, along with quizzes affect course progression. You can also award certificates, use time limits, set a passing score, limit quiz retakes and more.
NOTE
Quiz access & progression settings are set on a quiz-by-quiz basis. They cannot be set globally.
Table of Contents [show]1 Quiz Access Settings1.1 Associated Course1.2 Associated Lesson1.3 Quiz Prerequisites1.4 Registered Users Only2 Quiz Progression & Restriction Settings2.1 Passing Score2.2 Quiz Certificates2.3 Quiz Retakes2.4 Question Completion2.5 Time Limit2.6 Was this article helpful to you?
Quiz Access Settings
Aside from course progression, there are two main ways you can restrict access to a LearnDash quiz.

Navigate to LEARNDASH LMS > QUIZZES
Click on the quiz you』d like to edit
Click on the Settings tab
Locate the Quiz Access Settings section

Associated Course
You can associate a quiz to a specific course from this setting. The quiz will reflect on that course』s Builder.

Next to Associated Course, click inside the drop-down
Search for and select the name of the course
Click on the course to associate your current quiz with the course

Any changes in the association that you make on the course builder on the specific course for this quiz will also reflect the changes here.
Associated Lesson
In addition to associating the quiz to a course with the above options, you can also associate the quiz to a lesson or topic. The quiz will reflect on the course』s Builder.

Next to Associated Lesson, click inside the drop-down
Search for and select the name of the lesson or topic
Click on the lesson or topic to associate your current quiz with the course

Any changes in the association that you make on the course builder on the specific course, lesson, or topic for this quiz will also reflect the changes here.
Quiz Prerequisites
You can select one or more quizzes as prerequisites for a quiz. The quiz(zes) you choose must be completed prior to starting this quiz.

Next to Quiz Prerequisites, click inside the box
Search for and select the name of a quiz
Click on that quiz to add it as a prerequisite

If a user tries to access a quiz before completing the prerequisites, they will see a message on the quiz page that lists the name of the quiz(zes) that must be completed first.
Registered Users Only
You can also choose to only allow registered users to access the quiz. Simple check the box to enable this setting. Common uses for this setting include:

If you』re administering a quiz via shortcode on a non-course page
If you have a quiz on an 「Open」 course (see course access modes), but you only want authenticated users to be able to take the quiz

Quiz Progression & Restriction Settings
These settings discuss various options for quiz passing percentages, awarding certificates, time limits and retakes.

Passing Score
The passing score represents the score, as a percentage, that the user must attain before the quiz is considered complete. This will prevent the user from moving forward in the course until they have passed the quiz.
This must be a number between 0 and 100.
TIP
Set this value to 0 if you want the user to be able to continue the course as soon as the quiz is submitted, regardless of their score.
Quiz Certificates
If you』d like to award the user a certificate for this quiz, you may choose a certificate here. You need to create a certificate first.

Click the 「Search or select a certificate…」 dropdown
Choose a certificate from the list

After you select a certificate, you have the option to choose a score that the user is required to attain in order to awarded the certificate. This can be different from the passing score above. For example, a user could pass the quiz with an 80% score, but might be required to attain a 90% score to be awarded a certificate.

Enter the score in the box next to Certificate Awarded for

Quiz Retakes
Here you can control the number of quiz retakes that a user can have. Leave this setting disabled to allow unlimited retakes.
To put a limit on the number of retakes allowed:

Enable the toggle to Restrict Quiz Retakes
Enter the number of retakes allowed next to Number of Retries Allowed
You can set the retake limit to apply to all users, only registered users, or only anonymous users

(Optional) Check the box to use cookies to track retakes for anonymous (non-logged-in) users

Question Completion
Enable this setting to require the user to answer all questions. They will not be able to submit the quiz until all questions are answered.
Leave disabled to allow users to submit the quiz without answering all questions. Questions not answered will be marked incorrect.
Time Limit

Enable the Time Limit toggle if you』d like to limit the amount of time a user can spend on the quiz. The quiz will be automatically submitted after your specified amount of time.
Next to Automatically Submit After, enter a time in the format HH:MM:SS (hours, minutes, seconds). Here』s an example of a 1 hour, 30 minute time limit.

Leave this setting disabled for the user to have an unlimited amount of time to complete the quiz.

Was this article helpful to you?

Yes

No

SCORM and xAPI

SCORM and xAPI

SCORM 1.2 and SCORM 2004 are supported for Articulate, iSpring, and Adobe Captivate by using a third-party add-on (GrassBlade xAPI Companion or Tin Canny add-on by Uncanny Owl). These add-on allow you to insert the SCORM content into your LearnDash courses.
NOTE
Content created within LearnDash is not SCORM compliant.
​If you go the route of xAPI, you』ll need to specify a Learning Record Store (LRS) as well. We recommend one of the following:

GrassBlade LRS (includes a direct LearnDash integration)
Essentials LRS
Learning Locker (managed service offered here)

If you don』t need data (as in xAPI data) obtained from the file itself, then you can launch Articulate Storyline or Adobe Captivate in LearnDash using the following free plugin:
LearnDash Topic Progression Using Storyline/Captivate

Was this article helpful to you?

Yes

No

Global Assignment Settings

Global Assignment Settings

There are a few global settings that apply to all assignments. We recommend you adjust these settings first, before you start allowing users to upload assignments.
To access your global assignment settings:

Navigate to LEARNDASH LMS > ASSIGNMENTS
Click the Settings tab

Table of Contents [show]1 Search2 Publicly Viewable3 Comments Enabled3.1 Was this article helpful to you?
Search
Enable this setting if you want assignments to be included in search results when using the default WordPress search form on the front-end of your site.
NOTE
Search has nothing to do with Google search results. Google will index your assignments (if you』ve made them public viewable) regardless of this setting.
Publicly Viewable
This is part of the WordPress Custom Post Type logic and means the assignment can be shown on the front-end like other post types.
If you plan on making comments on user』s assignments, and you want them to be able to view those comments on your site, you』ll want to enable this setting.
When you turn this setting on, a unique page will be accessible for each and every assignment that is uploaded. The primary reason this page exists is to keep track of feedback and comments on the assignment.
NOTE
When this setting is enabled, assignment posts are only viewable by the admin, group leader, and student who uploaded the assignment.
Comments Enabled
This setting must be enabled in order for you to provide comments on uploaded assignments. Turning it on will enable WordPress』 default commenting system, so you』ll be able to provide feedback on a user』s assignment. The user will be able to respond with comments of their own.

Was this article helpful to you?

Yes

No

Quiz Display & Content Settings

Quiz Display & Content Settings

LearnDash quizzes come with a plethora of display options. You can add materials, show/hide a handful of different elements, autostart quizzes, display numbering, randomize answers and more.
Table of Contents [show]1 How to Access Settings2 Quiz Materials3 Autostart4 Question Display5 Question Overview Table6 Custom Question Ordering7 Additional Question Options8 Quiz Title8.1 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 Display and Content Options section

NOTE
Quiz display & content 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 Materials
Quiz materials are supplemental materials that you want to provide for the quiz. It is most common to include PDF files or other downloadable files in this area, but you can include anything you』d like (PDFs, images, downloadable audio files, links to other websites, etc.).

Next to Quiz Materials, toggle the switch on
Add your materials in the box (HTML is supported)
See here for example HTML →

NOTE
Quiz materials are shown to any user who has access to the quiz.
They are displayed to your users in a separate tab, alongside the main quiz content.

Autostart
Enable this setting to automatically load the quiz as soon as the user accesses the quiz page.
By default, this setting is disabled, and a 「Start Quiz」 button must be clicked to start the quiz.

Before we cover all the various elements of a quiz, please familiarize yourself with the following terminology. We』ll explain how to show/hide/enable/disable all of the following elements:

Question Display
The question display gives you two main options for how you want to set up your quiz questions:
1. One question at a time

Only one question is shown at a time
A 「Next」 button is displayed at the bottom of each question to proceed to the next one

If you choose this option, you have two ways to display results:

At the end only
All questions are graded together, at the end of the quiz. Choosing this option will allow you to optionally display a 「Back」 button that allows the user to review the previous question.
After each submitted answer
Each question is graded one at a time, immediately after it is submitted. The 「Back」 button is not an option here.

2. All questions at once

All questions are displayed on the page
You can choose the number of questions to be displayed before pagination appears at the bottom (enter 0 to show all questions)
No navigation buttons will be shown
A 「Quiz Summary」 button is shown at the end, followed by a 「Finish Quiz」 button to submit your answers

Question Overview Table
The question overview table displays a table at the top of your quiz.

It contains a number for each quiz question that your quiz contains
Users can click each number to take them to that particular quiz question
The question that is currently being viewed is marked in blue
Users can click a 「Review question」 button to mark a question as 「for review」
Answered questions are marked in green
A 「Quiz summary」 button allows user to see how many questions they have answered, and click 「Finish quiz」 to submit their answers

NOTE
These colors will depend on the accent and warning colors set on your LearnDash General Settings. By default, they should appear similar to the above screen capture.
Custom Question Ordering
By default, your quiz questions are displayed in the order they are set in the quiz builder. If you』d like to change that order, you have a few options:

Sort by Category: This will group all questions within the same category together.
Randomize Order: Just as it implies, this displays quiz questions in a random order. You can apply the randomization to all questions, or only a subset of questions.

Additional Question Options
There are a handful of other quiz elements that you can choose to show or hide from your users. Enable the toggle to display the following elements:

Point Value: Displayed in the top-right corner of each question. 10 point(s)
Question Category: Displayed just above the question. Only shown for questions that have been assigned a category. Category: Math
Question Position: Displayed at the very top of each question, indicating the current question out of the total questions. Question 1 of 10
Question Numbering: Displayed before each question. 10. Question
Number Answers: Displays a number before each answer (only applies to Single Choice and Multiple Choice question types)
Randomize Answers: Applies to Single Choice, Multiple Choice, Sorting & Matrix Sorting question types

Quiz Title
Enable this setting to output the LearnDash quiz title. This is recommended if you』re displaying the quiz via shortcode, or anywhere other than the default quiz page.
Most WordPress themes already display the main page title, so in many cases, this can be left disabled, otherwise you might see two of the same title on your page.

Was this article helpful to you?

Yes

No

Course Sections

Course Sections

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.
Course sections provide an additional way to organize your content. You can still structure your course into lessons and/or topics, but now you can add optional sections as well.

Table of Contents [show]1 What Are Course Sections?1.1 Example2 How to Use Sections2.1 Add New Section2.2 Move Sections2.3 Remove Sections2.4 Was this article helpful to you?
What Are Course Sections?
Sections are simple, text-only headings that can be used to break your course content into… sections. They can only be added at the top-level within a course. In other words, sections must be placed before (and outside of) lessons.
✅ Course → Section → Lesson → Topic
❌ Course → Lesson → Section → Topic
Other important notes regarding sections:

Sections are text-only headings. They do not directly contain content. All content is still placed within lessons and/or topics.
There is no limit to the number of sections you use.
Sections are unique to every course. They cannot be shared across multiple courses.

Example
It might be helpful to look at a few situations where you might want to use a course section. Here are a few examples:

Your course only consists of lessons (you』re not using topics at all)
You have 40 total lessons
Those 40 lessons discuss 4 main themes, each theme consisting of 10 lessons

In this example, you might want to use a section before each group of 10 lessons that relate to a particular theme. Your setup might look like this:
Theme 1 (section)

Lesson 1

Lesson 10

Theme 2 (section)

Lesson 1

Lesson 10

… and so on.
How to Use Sections
Add New Section
Before adding a section, you can click on an existing lesson to select it (it will be outlined in blue). Now, when you add a new section heading, it will be placed immediately after the lesson you have selected.
Within the course builder (below any lessons or topics you have already added):

Click the + New Section Heading link
Type the name of your heading
Hit Enter, or click the Add Section Heading button

Move Sections
To drag & drop a heading:

Immediately preceding the section heading, look for an icon with 6 dots
Hover over that icon
Click and hold down your mouse
Drag the section to its new location
Release your mouse

To move a section up or down one level at a time:

Locate the up and down arrows immediately preceding the section heading
Click either arrow to move the section in your desired direction

Remove Sections
To remove a section:

Hover over the section you』d like to remove
Click the red Remove link

Was this article helpful to you?

Yes

No

Manage Assignments

Manage Assignments

This article will walk you through all the ways in which you can manage uploaded assignments. If you have not yet read our article on how to enable assignments, we recommend reviewing that first.
Table of Contents [show]1 Viewing Assignments1.1 Where to Find Them1.2 Assignments Per Page1.3 Filter Assignments1.4 Search Assignments2 Download Assignments3 Approve Assignments3.1 What the User Sees4 Award/Adjust Points4.1 What the User Sees5 Provide Feedback/Comments6 Delete Assignments7 Notifications7.1 Was this article helpful to you?
Viewing Assignments
By default, admins with the Administrator role will be able to fully manage all uploaded assignments, and Group Leaders can manage assignments uploaded by users who are part of the group that they administer. However, there are user management plugins that allow you to expand these capabilities to other users & user roles.
Where to Find Them

Navigate to LEARNDASH LMS > ASSIGNMENTS
You』ll immediately land on the All Assignments screen, where you can see all uploaded assignments

A few things to keep in mind when viewing assignments.

By default, you』ll see a maximum of 20 assignments per page
Assignments are sorted in reverse chronological order (most recently uploaded assignment appears first, at the top)
Use the navigation arrows at the top & bottom of the table to locate the rest of your assignments (if you have more than 20)

Assignments Per Page
If you』d like to view more than 20 assignments at a time:

Click the Screen Options tab at the top of the page
In the 「Number of items per page」 box, enter your desired number of assignments
Click the Apply button

NOTE
The higher the number you set, the longer it will take this admin page to load. In most cases, we don』t recommend you go much higher than 100 per page.
Filter Assignments
If you have hundreds or thousands of assignments, viewing all assignments on one page based on when they were uploaded might not be the most helpful. You can filter assignments based on the following criteria:

Date uploaded
Course uploaded to
Lesson uploaded to
Approval status

To filter assignments:

Locate the filter bar near the top of the screen
Click the dropdown menu for the criteria you want to filter by
Choose a date, course, lesson or approval status
Click the Filter button

You can use multiple filters at once. For example, you can filter by assignments uploaded in March 2019, to Course A, which are Not Approved.
Search Assignments
Another way to locate a specific assignment is to search for it.

You can only search the Title column, which is equal to the file name. You cannot search by author or user』s name.
If you plan to utilize the search feature while managing assignments, you might want to ask your users to name their file in a specific way so they are easier for you to find.

If you allow multiple file types to be uploaded, you can use the file extension to find all assignments of the same file type. For example:

Search pdf to find all PDF files
Search mp3 to find all mp3 audio files

Download Assignments
There are two ways to download a user』s assignment.
From the 「All Assignments」 screen (easiest):

Hover over the row that contains the assignment you want to download
Click the Download link

From the single assignment view:

From the All Assignments screen, click on an assignment to edit it
Locate the box titled Assignments
At the bottom, next to Actions, click the Download button

Approve Assignments
WARNING
Once you』ve approved an assignment, you cannot unapprove it.
You can approve an assignment from the All Assignments screen, or on any individual assignment.
From the 「All Assignments」 screen:

Under the Status column, simply click the Approve button

When viewing an individual assignment:

Scroll down to the Assignments box
Next to Points, click the Update & Approve button
(adjust the points first, if necessary)

What the User Sees
When assignments are pending approval, the user will see a note explaining that they have assignments awaiting approval.

Award/Adjust Points
If you』ve enabled points for an assignment upload, you can adjust them at any time.
From the 「All Assignments」 screen:
You can only adjust points on this screen if the assignment has not been approved yet.

In the Points column, enter the number of points you』d like to award
In the Status column, click the Approve button

If the assignment has already been approved, you can adjust points from the individual assignment page.

Click on the assignment you』d like to adjust points for
Scroll down to the Assignments box
Next to Points, enter the points you』d like to award
Click the Update & Approve button

NOTE
Adjusting points is always available, even after you』ve approved an assignment. There is no limit to the amount of times you can adjust the points.
What the User Sees
When viewing a lesson or topic to which they』ve uploaded an assignment, the user will see how many points were awarded for each assignment.
Provide Feedback/Comments
As a course administrator, you have the ability to provide feedback (or comments) on assignments.
NOTE
Make sure you』ve enabled comments in your global assignment settings.

From the All Assignments screen, click on the assignment you』d like to provide feedback on
Scroll down to the Comments box
Click the Add Comment button
Type in your feedback
Click the Add Comment button once more

When your users view the lesson or topic that they uploaded assignments to, they』ll be able to see that you』ve posted a comment.

They can click on the comment icon to be taken to the individual assignment page where all comments are listed.
They』ll be able to respond with their own comments, as well.

Delete Assignments
Many course administrators choose to keep all assignments so they can be referred back to. However, you might want to delete your assignments (when a course is over, if the user is no longer a student in the course, etc.).
To delete an assignment:

From the All Assignments screen, hover over the row for the assignment that you want to delete
Click the red Trash link

The assignment will immediately disappear from the lesson/topic page, and the user will no longer be able to see it.
However, as an admin, the assignment is placed in a trash bin. It can be recovered for up to 30 days, at which point it will then be permanently deleted.
Notifications
It』s also possible to send & receive notifications about activity on assignments, to both administrators & users. The following options are available:

When a user has uploaded an assignment
When an assignment is approved

For instructions on how to set this up, please reference our documentation for the Notifications Add-On.

Was this article helpful to you?

Yes

No