User Guides

User Guides

User Guides provide detailed information on popular LearnDash features. Check back often as this section will be continually growing.

  • Course Sections
  • Focus Mode
  • User Profiles
  • Login & Registration
  • Video Progression
  • Translation
  • Sample Lessons (In Progress)

Contact support to make suggestions for a guide you would like us to make!

Course Sections

NOTE
This feature was introduced in LearnDash 3.0 and works with the newLearnDash 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.

Example of LearnDash course sections

Table of Contents [show]

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):

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

Add new section heading in LearnDash

Move Sections

To drag & drop a heading:

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

Move section headings in LearnDash

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

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

Remove Sections

To remove a section:

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

Focus Mode

NOTE
This feature was introduced in LearnDash 3.0 and works with the newLearnDash 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]

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:

LearnDash Focus Mode, desktop example
Example of Focus Mode applied on desktop

Here’s what it looks like on a mobile device:

Focus Mode applied on mobile
Example of Focus Mode applied on mobile
Focus Mode mobile menu tray
Focus Mode’s mobile menu tray

Enable Focus Mode

There are three important steps in order to enable focus mode:

  1. You must be using LearnDash 3.0 or higher
  2. You must be using the “LearnDash 3.0” template
  3. 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

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:

  1. Navigate to LEARNDASH LMS > SETTINGS
  2. In the Design & Content Elements section, look for Logo Upload
  3. Click the Select image button
  4. Choose an image from your Media Library, or upload a new one
  5. Click Use this image at the bottom
  6. 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.

Logo used in focus mode

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:

  1. Navigate to APPEARANCE > MENUS
  2. Click the Create a new menu link
  3. Under Menu Settings, select LearnDash: Focus Mode Dropdown
  4. Create/add your new menu items
  5. 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:

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]

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:

Insert the LearnDash profile block in admin

  1. Create a new page in WordPress
  2. Click the + icon to add a new block
  3. Search for “LearnDash Profile”
  4. 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 Profile, frontend example

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

LearnDash Profile frontend example in Legacy theme

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:

  1. Insert the “LearnDash Course List” block
  2. Set the “My Courses” option to “Show Enrolled Courses only”

LearnDash Course List Block, enrolled courses only setting

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:

Uncanny LearnDash Toolkit's UO Dashboard shortcode output

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:

  1. Install & activate the free Uncanny LearnDash Toolkit plugin
  2. Navigate to UNCANNY TOOLKIT > MODULES
  3. Enable the “Resume Button” module
  4. 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.

WooCommerce account page with LearnDash Profile
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…

  1. Create a new page in WordPress
  2. 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.

Inserting WooCommerce account & LearnDash profile blocks

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

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 (WooCommerceEasy Digital Downloads)
  • membership plugins (MemberPressPaid 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.

LearnDash Login & Registration

NOTE
This feature was introduced in LearnDash 3.0 and works with the LearnDash 3.0 template. This feature does not work with the Legacy template.

There are many ways to handle an existing user’s login & new user’s registration process. LearnDash has always provided great flexibility for you to choose how to handle this. As of version 3.0, we now have our own built-in login & registration process. You no longer need a third-party plugin to create a seamless login and/or registration process for your users.

LearnDash login & registration frontend example

Table of Contents [show]

Walkthrough Video

Enable LearnDash Login & Registration

There are four important steps in order to enable LearnDash login & registration:

  1. You must be using LearnDash 3.0 or higher
  2. You must select “LearnDash 3.0” as your active template
  3. You need to enable the Login & Registration option in the LearnDash general settings
  4. IMPORTANT: You need to enable registration for your WordPress site by selecting the Anyone can register checkbox located under SETTINGS > GENERAL (only necessary if you want to allow registration)

Enable LearnDash login & registration in settings

While not required, we recommend uploading a logo to use on the login screen. This logo will appear below the login form. To upload a logo:

  1. Navigate to LEARNDASH LMS > SETTINGS
  2. In the Design & Content Elements section, look for Logo Upload
  3. Click the Select image button
  4. Choose an image from your Media Library, or upload a new one
  5. Click Use this image at the bottom
  6. 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.

Upload logo used in login/registration modal

How It Works

The native LearnDash login & registration works in a few different ways, depending on the following:

  • Whether or not the user is currently logged in
  • The access mode assigned to the course

NOTE
LearnDash login & registration does not affect the default WordPress login page located at yoursite.com/wp-login.php. You can still use a third-party plugin to customize the default WordPress login page, and users can still login that way.

Logged In Users

Logged in users will never see a login link because they are already logged in.

  • If the user has access to the course, they’ll see a progress bar at the top of the page, and be able to navigate through the course steps
  • If the user is logged in but does not have access to the course, they’ll see the “Take this Course” button

“Open” & “Closed” Courses

These course access modes will never show a login link, and thus will never use this feature.

  • Open courses are available to everyone, even those not logged in. Since it is not necessary to login to view these courses, no login link is shown.
  • Closed courses are most commonly used for integrating with a third-party ecommerce or membership plugin. Login & course access is usually handled via the third-party plugin.

“Free” Courses

Visitors viewing a course with access mode set to “Free” will see a Login to Enroll button. Upon clicking this button, a registration form will appear for the user to sign up for an account to gain access to the course (or login if they already have an account).

LearnDash free course, login to enroll button

“Buy Now” & “Recurring” Courses

Visitors viewing a course with access mode set to “Buy Now” or “Recurring” will see a login link in the “Take this Course” section. If the user has already purchased & enrolled into the course, they can use the “Login” link to open the registration form & sign into their account. If not, they can click the “Take this Course” button to pay via your configured payment gateway (StripePayPal or 2Checkout).

Shortcode Option

If you would like to use the log-in modal pop-up somewhere other than a course page, then you can do so by using the following shortcode:

[learndash_login]

You can place this shortcode onto a regular WordPress page, post, widget (for the sidebar), and it will display a Login link for visitors, and a Logout link for anyone who is logged-in.

When a visitor clicks on the Login link, the LearnDash login & registration modal will appear.

Using The Shortcode as a Menu Item

If you want to add the Login & Registration modal as a WordPress menu item then it is possible by adding a custom link to your menu.

  1. Navigate to APPEARANCE > MENUS
  2. Select the desired menu location
  3. At the top right of the screen, select the Screen Options tab
  4. Select all options under Show advanced menu properties
  5. Under the Add menu items section, select Custom Links 
    — In the URL field, add #login
    — In the Link Text field, add “Login”NOTE: The Link Text is not what will be shown in the menu. That will be configured in Step #7.
  6. Click Add to Menu 
  7. Expand the new menu item and add the following:
    — In the CSS Classes (optional) field, add ld-button
    — In the Description field, add [learndash_login login_label="Login"logout_label="Logout"]
  8. Click Save Menu

Video Progression

Video progression is a way to require users to watch the entirety of a video before they can mark content as complete. It can be used for both lessons & topics, and works the same way for both. By default, the video will appear above your page content, but you can place it manually on the page using the [ld_video] shortcode.

This guide will walk you through the settings of video progression and explain how it works.

Table of Contents [show]

How to Enable It

LearnDash video progression admin settings

  1. Navigate to a lesson or topic edit screen in the admin
  2. Video progression is found on the Settings tab, under Display & Content Options
  3. Toggle the switch to turn it on
  4. Configure your settings (which we’ll discuss below)

Supported Video Providers

The video progression feature supports the following video providers:

  • Vimeo (vimeo.com)
  • YouTube (youtu.be or youtube.com)
  • Wistia (wistia.com)
  • Amazon S3
  • Local videos (uploaded to the WordPress Media Library)

Video URL

Enter the URL of the video you’d like to use for video progression. The Video URLfield accepts the following formats:

    • Video Watch URL
      ex: https://www.youtube.com/watch?v=hcSTaMhZi64
      ex: https://vimeo.com/115119775
      ex: https://yoursite.com/wp-content/uploads/2019/06/video-name.mp4