Overview
LearnDash is a top-tier LMS plugin that turns your WordPress website into a learning portal. Groundhogg provides direct integration with LearnDash, allowing you to trigger automation flows from student activity, enroll or remove students from courses as a flow action, and automatically apply or remove tags based on course, lesson, and quiz events.
You can download this add-on from the Groundhogg website or as part of a plan and install it on your website.
Triggers
The LearnDash integration comes with one trigger: LearnDash Progress. Drag it into any flow from the Triggers panel.
LearnDash Progress
This trigger executes based on a student’s activity in LearnDash. Configure it by selecting:
When a contact…
- Enrolls in a course
- Completes a course
- Completes a lesson
For any of the following courses…
- Select one or more available courses. Leave blank to match any course.
And for any of the following lessons… (Only relevant when “Completes a lesson” is selected.)
- Select one or more available lessons from the chosen course(s). Leave blank to match any lesson.
You can select multiple events in a single trigger step. For example, you can trigger on both “Enrolls in a course” and “Completes a course” in one step.
Actions
The LearnDash integration comes with one action: Change Enrollment. Add it anywhere in a flow to manage a student’s access to a course.
Change Enrollment
This action enrolls or removes a student from a LearnDash course. Configure it with:
- Action — Select Enroll Student or Un-enroll Student
- Course — Select the course to enroll in or remove from
Note: If the contact does not yet have a WordPress user account, one will be created automatically before enrollment is processed.
Tagging
The LearnDash integration adds a Groundhogg Integration panel to the edit screen of every course, lesson, and quiz. Use these panels to automatically apply or remove tags when a student reaches certain milestones, without needing a funnel.
Courses
The Groundhogg Integration panel on a course edit screen has four tag pickers, split into two sections:
Start of Course — fires when a student clicks the “Take This Course” button and is enrolled:
- Add Tags — tags to apply when the student starts the course
- Remove Tags — tags to remove when the student starts the course
End of Course — fires when the student completes the course:
- Add Tags — tags to apply when the course is completed
- Remove Tags — tags to remove when the course is completed
Lessons
The Groundhogg Integration panel on a lesson edit screen has two tag pickers, both of which fire when the student completes the lesson:
- Add Tags — tags to apply on lesson completion
- Remove Tags — tags to remove on lesson completion
Quizzes
The Groundhogg Integration panel on a quiz edit screen has two tag pickers, both of which fire when the student completes the quiz:
- Add Tags — tags to apply on quiz completion
- Remove Tags — tags to remove on quiz completion
Save the course, lesson, or quiz after selecting tags to apply your changes.
Contact Info Card
Every contact record shows a LearnDash LMS info card in the right sidebar. The card displays the student’s complete enrollment history at a glance:
- Student ID — links to the student’s WordPress user profile
- Course Enrolled — total number of courses the contact is enrolled in
Below the summary, each enrolled course is listed as an expandable panel showing:
- Course name (linked to the course page) with a status pill: Not Started, In Progress, or Completed
- A visual progress bar showing completion percentage
- Number of lessons completed out of total (e.g. “3 out of 10 lessons completed (30%)”)
- The date the student started the course (or the group access date if enrolled via a group)
If the contact does not have a linked WordPress user account, or has no course enrollments, the card displays “No enrollments yet.”
FAQs / Troubleshooting
Q. Does the LearnDash Progress trigger fire if I enroll a student manually from the WordPress admin?
A. Yes. The trigger fires on the learndash_update_course_access hook, which is called whether enrollment happens via the front-end “Take This Course” button, a Groundhogg flow action, or manual admin enrollment.
Q. Can I trigger a flow when a student completes a specific quiz?
A. Not directly via the LearnDash Progress trigger, which only covers course enrollment, course completion, and lesson completion. For quiz completions you can use the Tagging panel on the quiz edit screen to apply a tag, then use a Tag Applied trigger in your flow to react to that tag.
Q. What happens if a student’s contact record doesn’t exist yet when they enroll in a course?
A. The tag and trigger integrations look up the contact by the student’s WordPress user email. If no matching contact is found, nothing happens. The contact must already exist in Groundhogg. If you are using the Change Enrollment action in a flow, a WordPress user account will be created automatically if the contact does not have one, but the contact itself must already be in Groundhogg.
Q. Is there a sync tool to import existing LearnDash enrollments into Groundhogg?
A. No. The LearnDash integration does not include a bulk sync tool. The contact info card and tagging features only apply going forward from the point of installation.
Was this helpful?
Let us know if this document answered your question. That’s the only way we can improve.
