Assignments

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

Quizzes

Quizzes

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

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

Was this article helpful to you?

Yes

No

Group Display & Content Settings

Group Display & Content Settings

Each group can have its own set of display options. In this article, we will cover how each display setting affects your groups, and how you might want to adjust each setting to fit your particular needs.
Table of Contents [show]1 Locating Group Display Settings2 Group Materials3 Group Certificate4 Group Content5 Custom Pagination6 Custom Course Order6.1 Was this article helpful to you?
Locating Group Display Settings

Navigate to LEARNDASH LMS > GROUPS
Click on the group you want to edit
Click on the Settings tab at the top of the page
Locate the section titled “Display & Content Options”

Group Materials
Group materials are supplemental materials needed for your group members. It is most common to include PDF files or other downloadable or linkable files in this area, but you can include anything you’d like (PDFs, images, downloadable audio files, links to other websites, etc.).

Next to Group Materials, toggle the switch on
Add your materials in the box (HTML is supported)

Group materials are displayed to your users in a separate tab, alongside your main group content.

NOTE
Group materials are shown to all users (even those not enrolled in the group).
Group Certificate
You may want to provide a certificate to users who complete all courses assigned to their group. There are a few things to keep in mind:

You need to create a certificate first, then it will appear in this list for selection.
The certificate will become available after the user has successfully completed ALL courses associated with the group.
Once available, a button will appear on the group page for the user to download their certificate.

Simply select the certificate that you’d like to associate with this group.

Here’s how it looks to the user once it is earned:

NOTE
Certificates may also be associated with courses and quizzes.
Learn how to create a certificate »
Group Content
The group content setting determines who can see the list of courses associated with the group.
This does not affect the content that you add to the WordPress editor on the group page. That content will be displayed to everyone.

Always visible (default)
Display list to everyone, whether or not they are enrolled in the group.
Only visible to enrollees
Only display the list to users enrolled in the group.

Custom Pagination
Pagination refers to the number of courses that are displayed at one time before the user has to use small navigation buttons to navigate to subsequent pages to access additional courses in the group’s listing. By default, LearnDash will use your settings from the general settings page, but you may choose to customize this on a group-by-group basis.

Toggle the Custom Pagination setting on
Enter a number for courses per page

Custom Course Order
Custom group order refers to the order in which the associated courses are listed on the group page.

Toggle the Custom Course Order setting on
Choose a Sort By option

Date (default)
Title
Menu Order

Choose an Order Direction

Ascending (default)
Descending

NOTE
To control the default ordering settings, see the Global Group Settings documentation.

Was this article helpful to you?

Yes

No

Group Access Settings

Group Access Settings

The group access settings allow you to define a set of criteria for how a user gains and maintains access to your group and associated courses. This article will go through all the options, including payment settings, free access, prerequisites and more.
Table of Contents [show]1 Locating Group Access Settings2 Group Access Mode2.1 Free2.2 Buy Now2.3 Recurring2.4 Closed2.5 Was this article helpful to you?
Locating Group Access Settings

Navigate to LEARNDASH LMS > GROUPS
Click on the group you want to edit
Click on the Settings tab at the top of the page
Locate the section titled “Group Access Settings”

Group Access Mode
Access mode is how you determine the way in which someone can gain access to a group (free with registration required, one-time payment, recurring subscription, admin-enrollment, etc.). LearnDash has four group access modes available.
Free
The following rules apply to Free groups:

Must be registered/logged in to access
No payment is required
“Enroll in Group” button is shown to users not yet enrolled. They are sent through the registration process. See login & registration for more details.

The Free access mode is a good choice if you want users to self-enroll into the group.

Buy Now
The following rules apply to Buy Now (one-time payment) groups:

Must be registered/logged in to access
Requires a one-time fee to be paid (no free access)
Only works with the following payment methods: PayPal, Stripe & 2Checkout
Do not use if you’re selling group access via a shopping cart or membership plugin (see Closed below)

The Buy Now access mode does not allow you to use discounts/coupons. Consider using an ecommerce or membership integration, along with the Closed access mode.
When using the Buy Now mode, you need to enter a price in the Course Price field.

Select the Buy Now access mode
Enter your price in the Group Price field

NOTE
For both “Buy Now” and “Recurring” access modes, the user will be automatically enrolled into the group upon a completed payment.
Recurring
Recurring is very similar to Buy Now, except for recurring payments (as opposed to one-time payments).
The following rules apply to Recurring groups:

Must be registered/logged in to access
Requires a recurring fee (choose a billing cycle in X days, weeks, months or years)
Only works with the following payment methods: PayPal, Stripe & 2Checkout
Do not use if selling group access via a shopping cart or membership plugin (see Closed option below)

To set up the Recurring access mode:

Select the Recurring option
In the Group Price field, enter the amount you would like to charge
Enter the number of days/weeks/months/years at which frequency you would like the user to be billed
Choose either day(s), week(s), month(s) or year(s) from the dropdown

NOTE
Group access sold via PayPal will not be automatically revoked should the user stop the recurring payments. This will require the administrator to manually remove the user from the group.
Closed
The following rules apply to Closed groups:

Must be registered/logged in to access
Allows you to sell group access via an ecommerce or membership add-on*
Enables a custom Button URL field, which sends users to a custom sales or checkout page (a button is only shown if you enter a URL)
Option to manually enroll users into the group

When you choose Closed, you are essentially telling LearnDash to restrict access to your group. In order to enroll users into the group, one of the following (or both) can happen:

Let an ecommerce/membership add-on handle group access by associating the product or membership with the LearnDash group (see individual add-on instructions).
Manually add users  to the group (via the user’s WP Profile, or Group edit page). Must be an Administrator or Group Leader with proper capabilities enabled [insert URL].

NOTE
Existing groups created prior to LearnDash v3.2 will automatically be converted to the “Closed” access mode. You can edit these as needed.
 

Was this article helpful to you?

Yes

No

Group Users and Group Leaders

Group Users and Group Leaders

Groups are made up of two types of users. Enrollees (group users) who enroll into the group to take the related courses, and Group Leaders, who oversee and manage the group.

Table of Contents [show]1 Group Leader1.1 What is a Group Leader?1.2 Creating a Group Leader1.3 Assigning a Group Leader to a Group2 Group Users2.1 Was this article helpful to you?
Group Leader
What is a Group Leader?
Group Leader is a user role included in LearnDash. By default, it adds the ability to…

view reports on course progress for any user in the group
view reports on quiz performance for any user in the group
send email messages to the entire group

Group Leaders can also edit and create groups, as well as users. Read more about these Group Leader Settings here.
Creating a Group Leader
Before you can assign a Group Leader, you have to grant the Group Leader user role to the desired users (or create a new user as a Group Leader directly). After doing so, they will appear for selection when you create your group.

From your WordPress admin dashboard, navigate to USERS > ALL USERS
Select the checkbox next to the desired user(s)
From the Change role to… dropdown menu, select Group Leader
Click Change

Assigning a Group Leader to a Group
Once your Group Leader(s) have been created, you must assign them to the group. There are no limits on the number of Group Leaders that can be assigned to a group, but it must have at least one.
Assigning a Group Leader to a group is the same process as when you assigned courses.

Still on the Edit Group page…
Scroll down to Group Leaders
Choose on the user(s) you want to add as Group Leaders by clicking on their name. Hold CTRL (CMD on Mac) to select multiple courses at once.
Click the right arrow to move the user into the Assigned Group Leaders window

NOTE
A single Group Leader can oversee multiple groups.
Group Users
Any user role can be added as an enrollee of a group.
Adding users to your group is similar to how you added courses and Group Leaders.

Still on the Edit Group page…
Scroll down to Group Users
Choose the user(s) you want to add to the group by clicking on their name. Hold CTRL (CMD on Mac) to select multiple courses at once.
Click the right arrow to move the user into the Assigned Group Users window

Was this article helpful to you?

Yes

No

Group Leader Capabilities

Group Leader Capabilities

Here are the capabilities changes for each options under LEARNDASH LMS > GROUPS > SETTINGS.
NOTE
The ‘Advanced’ section includes the capabilities of ‘Basic’.
Table of Contents [show]1 Manage Groups2 Manage Courses3 Manage Users3.1 Was this article helpful to you?
Manage Groups
Basic capabilities:

edit_groups
edit_published_groups
delete_group, delete_groups
delete_published_groups
publish_groups

Advanced capabilities:

delete_others_groups
edit_others_groups
delete_private_groups
edit_private_groups
read_private_groups

Manage Courses
Basic capabilities:

edit_courses
edit_published_courses
delete_course
delete_courses
delete_published_courses
publish_courses
wpProQuiz_show
wpProQuiz_add_quiz
wpProQuiz_edit_quiz
wpProQuiz_delete_quiz
wpProQuiz_show_statistics
wpProQuiz_toplist_edit

Advanced capabilities:

delete_others_courses
edit_others_courses
delete_private_courses
edit_private_courses
read_private_courses
wpProQuiz_reset_statistics
wpProQuiz_import
wpProQuiz_export

Manage Users
Basic capabilities:

edit_users

Advanced capabilities:

list_users
create_users
delete_users

Was this article helpful to you?

Yes

No

Publishing and Viewing a Group

Publishing and Viewing a Group

Table of Contents [show]1 Publishing the Group2 Viewing the Group2.1 Before Publishing2.2 After Publishing2.3 Was this article helpful to you?
Publishing the Group
Once your group is ready to be published and you have:

Assigned a Group Leader to the group
Assigned courses to the group
Enrolled users into the group
Added optional content and materials to the group

Simply click the Publish button. Once the group is published, users of the group get enrolled into any course associated to that group.
Viewing the Group
You can view the group on the front-end in the same way you would view a regular WP Post or a LearnDash course.
Before Publishing
To preview what the group listing would look like to users in the front-end, simply click the Preview button from the group editing page. You can also click the URL above the group title which will show a preview for any draft groups.

After Publishing
To view the group in the front-end:

Navigate to LEARNDASH LMS > GROUPS.
Hover over the group in question, and click the “View” link.

NOTE:
Similar to Draft groups, you can also click the URL above the group title to display the front-end page.

Was this article helpful to you?

Yes

No

Login & Registration

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

Certificate Shortcodes

Certificate Shortcodes

Certificate shortcodes are exclusively for creating LearnDash certificates. They allow you to display dynamic information about the user, as well as the course or quiz that you’re awarding the certificate for. You can insert the user’s name, course title, date of completion, quiz grade and much more.
There are 4 main shortcodes, and then each shortcode has a handful of parameters to output various information.

[usermeta] displays user info
[courseinfo] displays course info (only works with certificates assigned to a course)
[quizinfo] displays quiz info (only works with certificates assigned to a quiz)
[groupinfo] displays group info (only works with certificates assigned to a group)

All certificate shortcodes are also listed in the WordPress admin area under LEARNDASH LMS > CERTIFICATES. Click on the Shortcodes tab at the top.

Looking for the full list of shortcodes you can use throughout your LearnDash site? See all shortcodes »
Table of Contents [show]1 [usermeta]2 [courseinfo]3 [quizinfo]4 [groupinfo]4.1 Was this article helpful to you?
[usermeta]
The [usermeta] shortcode has a handful of options to display user information. Let’s take a look at each one.

[usermeta field=”first_name”] – Displays a user’s first name
[usermeta field=”last_name”] – Displays a user’s last name
[usermeta field=”display_name”] – Displays a user’s full display name, which is often a combination of {first_name} and {last_name}.
[usermeta field=”user_login”] – Displays a user’s username
[usermeta field=”nickname”] – Displays a user’s nickname (might not be captured upon user signup)
[usermeta field=”user_email”] – Displays a user’s email address
[usermeta field=”user_url”] – Displays a user’s website address (likely not captured upon user signup)
[usermeta field=”description”] – Displays a user’s bio (likely not captured upon user signup)
[usermeta field=”id”] – Displays a user’s WordPress assigned unique user id (assigned chronologically by WordPress upon user registration)

The most common [usermeta] shortcodes you’ll use are [usermeta field=”first_name”] and [usermeta field=”last_name”], as almost all certificates should include the student’s name.
NOTE
Not all of these values are collected when a student registers for or purchases a course. Different registration methods collect different info. Check with your ecommerce or checkout solution to see which fields are collected upon signup. You can also check this yourself by going to USERS > ALL USERS, and clicking on a user to edit their profile.
[courseinfo]
The [courseinfo] shortcode should only be used for certificates assigned to a course. Let’s quickly define a few terms:

aggregate refers to the sum of all quizzes assigned to the course
cumulative refers to the average of all quizzes assigned to the course

Here are all the possible values:

[courseinfo show=”course_title”] – Displays the course title
[courseinfo show=”course_price”] – Displays the course price (only for one-time payment courses)
[courseinfo show=”course_price_type”] – Displays the Access Mode for the given course
[courseinfo show=”course_url”] – Displays the course URL
[courseinfo show=”course_points”] – Displays the total available points for the course
[courseinfo show=”user_course_points”] – Displays the amount of points the user earned for the course
[courseinfo show=”enrolled_on”] – Displays the course enrollment date (this does not apply to OPEN courses)
[courseinfo show=”completed_on”] – Displays the date the course was completed
[courseinfo show=”user_course_time”] – Displays the total time spent on a course
[courseinfo show=”cumulative_score”] – Displays the average score for all graded parts of the course
[courseinfo show=”cumulative_points”] – Displays the average points earned
[courseinfo show=”cumulative_total_points”] – Displays the average points earned
[courseinfo show=”cumulative_percentage”] – Displays the average percentage of all quizzes taken in the course
[courseinfo show=”cumulative_timespent”] – Displays the average time spent on each part of the course
[courseinfo show=”aggregate_score”] – Displays the final score received for the course
[courseinfo show=”aggregate_points”] – Displays the total points earned for the course
[courseinfo show=”aggregate_total_points”] – Displays the total points earned for the course
[courseinfo show=”aggregate_percentage”] – Displays the total percentage score for all quizzes taken as part of the course
[courseinfo show=”aggregate_timespent”] – Displays the total time spent on quizzes for the course as a whole

When using the completed_on parameter, you can also customize the date format. (See available date formats)
[courseinfo show=”completed_on” format=”F j, Y”]
[quizinfo]
The [quizinfo] shortcode should only be used for certificates assigned to a quiz. They will not work if used for a certificate assigned to a course.
Here’s a list of all available options to output quiz information on a quiz certificate:

[quizinfo show=”score”] –  Displays the score received for that quiz
[quizinfo show=”count”] – Displays the number of questions within the quiz
[quizinfo show=”pass”] – Displays the score required in order to pass the quiz
[quizinfo show=”timestamp”] – Displays the day/time when the quiz was completed
[quizinfo show=”points”] – Displays the points received by the user on the quiz
[quizinfo show=”total_points”] – Displays the total possible points that can be received for a given attempt
[quizinfo show=”percentage”] – Displays the percentage grade received by the user on the quiz
[quizinfo show=”quiz_title”] – Displays the name of the quiz
[quizinfo show=”course_title”] – Displays the name of the course that the quiz is associated with
[quizinfo show=”timespent”] – Displays the time spent taking the quiz

Again, you can customize the date format when using the timestamp option.
[quizinfo show=”timestamp” format=”F j, Y”]
[groupinfo]
The [groupinfo] shortcode should only be used for certificates assigned to a group. They will not work if used for a certificate assigned to a course or a quiz.
Here’s a list of all available options to output quiz information on a group certificate:

[groupinfo show=”group_title”] – Displays the group’s title
[groupinfo show=”group_url”] – Displays the group’s URL
[groupinfo show=”group_price_type”] – Displays the group’s Access Mode
[groupinfo show=”group_price”] – Displays the group’s price
[groupinfo show=”group_users_count”] – Displays the number of group enrollees
[groupinfo show=”group_courses_count”] – Displays the number of courses in the group
[groupinfo show=”user_group_status”] – Displays the group progress status of the user
[groupinfo show=”enrolled_on”] – Displays the date the user enrolled into the group
[groupinfo show=”completed_on”] – Displays the date the user completed all courses assigned to the group
[groupinfo show=”percent_completed”] – Displays the score achieved in the group’s courses

Again, you can customize the date format when using the timestamp option.
[groupinfo show=”timestamp” format=”F j, Y”]

Was this article helpful to you?

Yes

No

Group Page

Group Page

The Group Page content area is where you add a group title, description and featured image for your group. This is what people will see before they enroll into (or purchase) access to the group.
LearnDash will automatically add a course table with a list of courses associated to the group below the group description. Group Page content is your own custom information that will be displayed whenthe page is loaded underneath the “Group” tab.

Table of Contents [show]1 Where to Add a Group Page Content2 Group Title3 Group URL4 Group Description4.1 Shortcodes & Blocks5 Group Featured Image6 Group Attributes6.1 Was this article helpful to you?
Where to Add a Group Page Content

Navigate to LEARNDASH LMS > GROUPS
Click on the group that you would like to edit
You will automatically land on the Group Page tab
You can immediately start adding your group description

GUTENBERG vs. CLASSIC EDITOR
This article assumes you are using WordPress 5.0 or greater, which includes the new WordPress editing experience (aka: Gutenberg). If you are using the Classic Editor plugin then your experience will be different.
PAGE BUILDERS
If you have chosen to use a page builder plugin (Elementor, Beaver Builder, Divi, WPBakery, etc.) to edit your group description, you should refer to that specific page builder’s documentation on how to add content.
Group Title
Your group title is the first thing you’ll see at the top of the editing screen. Look for a placeholder that says “Add Group title.” Most themes display the title near the top of the page, below your header and/or global navigation.
Group URL
When you click inside of the “Add Group title” box, you will see an area appear labeled “Permalink.” This is your group URL.

The first two parts of the URL are not editable but are determined by your (part 1) site’s domain name and (part 2) the group slug you have chosen (which will be /groups/, unless you customized your LearnDash permalinks).
You can edit the third part of the URL:
https://yoursite.com/groups/my-first-group-URL
In most cases, this should be the same as your group title.

Click into the “Title” area, as if you were going to change your group title
Click the “Edit” button next to the permalink
Type your new permalink
Hit Enter, or click the Save button

NOTE
The Public setting must be enabled in order for you to be able to edit the group URL or permalink. Navigate to LEARNDASH LMS > GROUPS > SETTINGS, under the “Group Custom Post Type Options” section.
Group Description
Everything below the group title is a blank canvas for you to add your description. This is powered by the same WordPress editor used for pages and blog posts.
For more information on how to use the Gutenberg editor, please see the official WordPress Editor documentation.
Shortcodes & Blocks
LearnDash introduces a number of shortcodes & blocks for you to use in this area. To see available blocks, add your cursor in the description area and from your keyboard, use the slash “/” command. You can then narrow the list down by typing keywords such as “group” or “LearnDash”.
For a more detailed look into all of the available options, please read our shortcode & blocks article.
Group Featured Image
The featured image is the main image associated with your group. Most WordPress themes will display this image near the top of your group page. It is also the image LearnDash will display if you are using the course grid add-on along with the “LearnDash Group List” block or shortcode on a separate page.

Look for the Featured Image panel in the sidebar (make sure you’re viewing Document settings, not Block settings)
If not already open, click on it to open it
Click Set featured image
Choose an image from your Media Library, or upload a new one
Click the Select button at the bottom

NOTE:
Where and how your course title, description & featured image are displayed is heavily dependent on your WordPress theme. If you’re experiencing layout issues with this content, please contact your theme developer.
Group Attributes
The group attributes section works similarly to the default WordPress Page Attributes. There, you can specify the order of the groups (helpful if using Menu Order), as well as set a parent group if you have enabled the Group Hierarchy setting.

Group Parent allows you to select a parent group for the current group being edited. Group hierarchy is level-based. This means that any user enrolled in the parent group will have automatic access to the sub-groups. A user can however enroll into a sub-group by itself, without gaining access to the parent group.
Menu Order allows for controlling the order in which the groups appear. For example, when courses are listed via the LearnDash Group List block when the “Order by” option is set to Menu.

Was this article helpful to you?

Yes

No