Reporting

Table of Contents [hide]

Reporting

NOTE

These reporting features and blocks are part of new LearnDash versions starting from 4.17.0.


LearnDash includes a reports feature. It will give you additional insight into your courses, including completion metrics and the latest learner activity.


You can view data for a specific course, user, or group using filters. You can even put the reports onto the front end of your site using ProPanel Reports blocks, and shortcodes. Additionally, the email feature lets you quickly send messages to filtered users.


Dashboard & Widget Overview

There are five reporting widgets. These widgets are available under “LearnDash LMS > Reports.”

By default, Reports will only be visible to Admins and Group Leaders.

  • Admins will see all data
  • Group Leaders will only see data relating to the groups that they manage

Reports Overview Widget

Displays the number of students, courses, pending assignments, and pending essays (to be approved by admin or group leader). Each item is a clickable link that will let you view the selected section with more details.

Activity Widget

This widget displays real-time activity in your courses. Supported activities include course completion, lesson, topic, and quiz completion. Associated data, such as timestamps, scores, and steps, will be displayed when applicable.

You can export course and quiz reports via the buttons at the top of the widget. These reports will include only currently filtered data.

Admins will be able to view all user activity. Group Leaders, however, can only view activity from users in their group(s).

The number of items shown per page depends on the pagination in the LearnDash Report Filters widget (see below for more information).

Report Filters Widget

The Report Filters Widget lets you filter by course, user, or group. You can use any combination of these filters to narrow down your results.

Below are some examples.

User Filter → Select a user → Select a progress status

Generate a list of enrolled courses for a specific user and progress statistics for those courses.

Course Filter → Select a course → Select a progress status

Generate a list of users enrolled in the selected course and progress statistics for each user.

Group Filter → Select a group → Select a progress status

Generate a list of users in the selected group and progress statistics for each user.

Date Filter → Select a group, course, or user → Select progress status → Filter by Date

Filter the list of users further based on the selected group, course, or users. Leaving this empty will disregard the filter.

NOTE

When users filter by All Groups -> All Courses -> All Statuses,  it will show all the activities for learners on all their lessons and courses. For instance, if a learner is listed 29 times, that is because that’s the total number of lessons they have in the classes that she’s enrolled in.

Additional Options

  • Email lets you communicate with the users selected in the Filters section. Note that the emails will be sent using the default site administration email and site title. However, you can set “Email Sender Settings” under “LearnDash LMS > Settings > Emails.”
  • Pagination will control the output of both lists in the Reporting widget and the Activity widget.
  • Full Page will take you to a full-page view of the Reporting widget for a distraction-free and full-width environment.

Progress Chart Widget

Set the LearnDash Report Filters Widget to filter by group, course, or user, and two charts will appear.

On the left is the overall Progress Distribution chart, which shows the user or course distribution between “Not started,” “In Progress,” and “Completed” course statuses.

On the right is a breakdown of all users or courses that are “In Progress” in the selected filter (In Progress Breakdown). Use the default setting to display the in-progress distribution in 20% increments; 20, 40, 60, 80, and 100. You can change these increments and other items using the filters discussed in the Developer section posted later in this document.

Reporting Widget

The Reporting Widget displays the status of the user’s course progress against the filtered course in the ‘progress bar’ and percentage number.


If you hover over the ‘progress bar,’ it will display the number of completed steps.


You can use the ‘Report Filters’ widget to filter reports by course, user, group, or completion status and the Reporting widget will display reports accordingly.

Front-end Display of ProPanel

You can use LearnDash Reports on the front-end of your website in three ways: Blocks, Shortcodes, and accessing existing front-end templates. Let’s explore these three options.

Blocks

Create custom report templates with LearnDash Reporting blocks by placing them anywhere within the main content of a page or post.

NOTE

This is for the WordPress Gutenberg block editor only and requires LearnDash v4.8.0 or higher to be installed.

To learn more about the block editor, click here

Follow these steps to add LearnDash Reporting Blocks to your pages or posts.

  1. Create/edit a page/post
  2. Click the + icon to add a new block
  3. Search for “LearnDash Report” & click on the block you want to insert
  4. Adjust your settings in the Block options panel

The following blocks are available for your use:

  1. LearnDash Report Filters
  2. LearnDash Reports Overview
  3. LearnDash Progress Chart
  4. LearnDash Activity Report
  5. LearnDash Reporting
  6. LearnDash Full Report Link

Once you have finished adding the blocks you need, select Publish.

Additional Reporting


Additional reporting metrics are available using the following tools:

You might also be interested in one of the 3rd party reporting add-ons.

FAQ & Troubleshooting

My reporting widgets do not load any data. Why?

Make sure you are running the latest version of LearnDash. Then, go to LEARNDASH LMS > SETTINGS > UPGRADE DATA and upgrade the Course and Quiz data.

When I attempt to export my data, nothing happens. Why can’t I export my course or quiz data?

Check with your hosting provider to see if object caching is enabled. If it is, request to have this disabled, and the reports will generate.

My language has special characters that aren’t displaying correctly on the report export; how can I fix this?

Insert the code snippet listed at https://developers.learndash.com/hook/learndash_csv_object/ into your theme’s functions.php file.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.