LMS Integration
MediaShield overviewFree + ProGet MediaShield →
PRO - requires MediaShield Pro. For Learnomy, see the note under “Supported course plugins”.
Link a MediaShield video to a lesson in your course plugin. When a student finishes the video, the lesson is marked complete. You can also limit a video to students enrolled in the course.
Why use it
Section titled “Why use it”Students’ progress in your course plugin updates by itself when they finish the video, so nobody has to tick lessons by hand. You can also keep a video for enrolled students only.
Before you start
Section titled “Before you start”- Your course plugin is active: LearnDash, Tutor LMS or LifterLMS.
- The lesson exists, and the video is in your MediaShield library.
- Students are logged in. Guests never trigger completion.
Supported course plugins
Section titled “Supported course plugins”| Course plugin | What you can link | Detected by |
|---|---|---|
| LearnDash | Lessons and topics | LearnDash is active |
| Tutor LMS | Lessons | Tutor LMS is active |
| LifterLMS | Lessons | LifterLMS is active |
Detection is automatic. If none of these is active, the LMS Integration box does not appear on the video screen and the LMS card does not appear under Settings.
Learnomy works differently. Learnomy is not one of the three adapters above. The free MediaShield plugin supplies Learnomy with a signed embed link for a video when the lesson’s content type is MediaShield. Lesson completion in Learnomy is handled by Learnomy, not by this Pro feature. Other course plugins can be added by a developer. See Hooks and Filters.
Link a video to a lesson
Section titled “Link a video to a lesson”- Go to Videos and open the video.
- In the side column, find LMS Integration.
- Under the lesson list, choose the lesson. Lessons are grouped by course. LearnDash topics are marked “(Topic)”.
- Set Complete at % (below).
- Optionally tick Require enrollment to watch.
- Click Update.
Each list shows up to 200 lessons (and up to 200 topics in LearnDash). On a larger catalogue some lessons will not be offered.
Show the video on the lesson page
Section titled “Show the video on the lesson page”Once a video is linked, MediaShield adds the player to the end of that lesson’s content for you. Nothing else is needed.
- If the lesson already contains a
[mediashield ...]shortcode, MediaShield leaves it alone so the video does not show twice. - Access rules still apply. If the visitor fails the login, role or enrollment check, no player is added.
- To place it yourself, paste
[mediashield id=N]where you want it. Use the number shown in the video’s Embed This Video box.
A developer can turn automatic placement off with a filter.
When a lesson is marked complete
Section titled “When a lesson is marked complete”MediaShield records milestones at 25, 50, 75 and 100 percent. A lesson completes at the first milestone that is at or above your Complete at % value, so a setting of 90 completes the lesson at the 100 percent milestone, because there is no 90 percent milestone.
| Choice | Lesson completes at |
|---|---|
| Use global default | The site-wide value (default 100) |
| 100% (Must watch entire video) | The 100 percent milestone |
| 90% | The 100 percent milestone |
| 75% | The 75 percent milestone |
| 50% | The 50 percent milestone |
Milestones fire once per student per video, for good. Rewatching does not fire them again.
Require enrollment
Section titled “Require enrollment”Tick Require enrollment to watch on a video. Students who are not enrolled in the course that contains the linked lesson are blocked, with the message “You must be enrolled in this course to watch this video.” Administrators always pass. Guests are blocked.
The check applies only when the video has a linked lesson and the box is ticked. If the course plugin is not available (for example it was deactivated), playback is allowed rather than locking everyone out.
Site-wide LMS settings
Section titled “Site-wide LMS settings”Open MediaShield > Settings and find the LMS Integration card. It shows only while a supported course plugin is active.
| Setting | Default | What it does |
|---|---|---|
| Auto-complete lessons | On | Marks the linked lesson complete when the viewer reaches the completion point. Off stops completion everywhere |
| Require enrollment | On | The master switch for enrollment checks. On means each video’s own checkbox decides. Off disables enrollment checks on every video, even ones with the box ticked |
| Global completion % | 100 | The value used by videos set to “Use global default”. Choices are 25, 50, 75, 90 and 100. Values below 10 are raised to 10 |
Per-video values (stored on the video):
| Per-video setting | Default | What it does |
|---|---|---|
| Linked lesson | none | The lesson this video completes and gates |
| Complete at % | Use global default | Overrides the global value |
| Require enrollment to watch | Off | Gates this video by enrollment |
Milestone actions and LMS
Section titled “Milestone actions and LMS”Lesson completion and Milestone Actions respond to the same milestone. They are independent. Both can fire, and turning one off does not affect the other.
What viewers see
Section titled “What viewers see”On the lesson page the viewer sees the protected player at the end of the lesson content. If they are not enrolled and the video requires it, they see “You must be enrolled in this course to watch this video.” instead of the player. When they reach the completion point, the lesson shows as complete in the course plugin.
Next steps
Section titled “Next steps”- See every integration and its edition.
- Set up milestone actions such as a thank-you email at 100 percent.
- Read the heatmap for a lesson video.
If a lesson does not complete, see Troubleshooting.

