Tutor LMS

📅 Published on

📝 Last updated

Overview

Tutor LMS is a feature-rich, easy-to-use learning management plugin for WordPress. Groundhogg provides direct integration with Tutor LMS, allowing you to automatically apply or remove tags when students enroll in a course, complete a course, or complete a lesson.

You can download this add-on from the Groundhogg website or as part of a plan and install it on your website.

Tagging

The Tutor LMS integration adds tag pickers to the edit screen of every course and lesson. These let you configure tags that are applied or removed automatically based on student activity, without needing a funnel.

Courses

The Groundhogg Integration panel appears in the sidebar of every course edit screen. It has four tag pickers split into two sections:

Start of Course — fires when a student enrolls in the course:

  • Add Tags — tags to apply when the student enrolls
  • Remove Tags — tags to remove when the student enrolls

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

Save the course after selecting tags to apply your changes.

Lessons

Lesson tags are configured inside Tutor LMS’s own lesson edit modal rather than in a separate sidebar panel. When editing a lesson, scroll to the bottom of the modal to find the Groundhogg Integration section. It has two tag pickers, both of which fire when the student completes the lesson:

  • Add Tags — tags to apply when the lesson is completed
  • Remove Tags — tags to remove when the lesson is completed

Save the lesson after selecting tags to apply your changes.

Using Tags to Start Flows

Because the Tutor LMS integration works entirely through tags, you can use Groundhogg’s Tag Applied trigger in any flow to react to student activity. For example:

  • When a student enrolls, apply a tag → use Tag Applied to trigger an onboarding email sequence
  • When a student completes a course, apply a tag → use Tag Applied to send a certificate or upsell to the next course
  • When a student completes a lesson, apply a tag → use Tag Applied to send a follow-up or unlock the next lesson

FAQs / Troubleshooting

Q. Does the integration work if a student is enrolled manually by an admin?
A. The enrollment tags fire on Tutor LMS’s tutor_after_enroll hook, which is called when a student is enrolled via the front-end. Manual admin enrollments may not trigger this hook depending on how they are processed. Test your specific workflow to confirm behaviour.

Q. What happens if the student’s contact record doesn’t exist yet when they enroll?
A. The integration looks up the contact by the current user’s email address. If no matching contact is found in Groundhogg, nothing happens. The student must already have a contact record in Groundhogg for tags to be applied.

Q. Can I trigger a flow when a student completes a quiz?
A. The Tutor LMS integration only handles course enrollment, course completion, and lesson completion. Quiz completion is not currently supported. If Tutor LMS is used alongside WooCommerce or Easy Digital Downloads for e-commerce, those integrations provide additional triggers including cart abandonment.

Q. I don’t see the Groundhogg Integration section in the lesson modal. What’s wrong?
A. Make sure the Groundhogg Tutor LMS integration plugin is active. The lesson section is injected into Tutor LMS’s lesson edit modal, so it will only appear when editing a lesson from within the Tutor LMS course builder, not from the standard WordPress post editor.

Was this helpful?

Let us know if this document answered your question. That’s the only way we can improve.