Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Troubleshooting

LearnDash Video Progression Not Working: Causes and How to Fix It

LearnDash Video Progression Not Working: Causes and How to Fix It

Short answer

LearnDash only tracks videos added in the Video URL field of a lesson's video progression settings, so embedded videos in the content are ignored. If the field is used, check that the host allows embedding, exclude LearnDash and player scripts from JavaScript delay, and make sure a cookie banner is not blocking the player.

Key takeaways

  • Add the video in the Video URL field, not in the lesson content.
  • Private YouTube videos and Vimeo domain privacy can block tracking.
  • JavaScript delay and iframe lazy loading often stop the player API.
  • Cookie consent tools may block video players for new visitors.
  • Display timing can hide the video until sub-steps are complete.
  • Always test as a real student, not as an admin.

Why is LearnDash video progression not working?

LearnDash video progression usually fails because the video sits in the content instead of the Video URL field, the player is blocked, or a speed plugin delays the tracking script.

A cookie consent banner that stops the player loading is another common cause.

Video progression is the LearnDash feature that makes students watch a lesson or topic video before they can mark it complete or move on.

When it breaks, the symptoms vary. The Mark Complete button may show too early, never show at all, or the lesson may not auto-complete when the video ends.

LearnDash explains how the feature is meant to work in its video progression documentation. The checks below go from most common to least common cause.

Is the video added through the Video URL field?

LearnDash only tracks videos added in the Video URL field of the video progression settings, so a video embedded in the lesson content with a block or shortcode will not be tracked.

This is the most frequent mistake. The video plays, but LearnDash has no idea it exists, so progression does nothing.

How to set it up correctly:

  1. Edit the lesson or topic.
  2. Open the Settings tab.
  3. Turn on Video Progression.
  4. Paste the video address or embed code into the Video URL field.
  5. Remove any second copy of the same video from the lesson content.
  6. Update the lesson.

If you keep the video in both places, students may watch the untracked copy and wonder why nothing happens.

For a refresher on how lessons and topics fit together, see our overview of what LearnDash LMS is.

Is the video host supported and the address format right?

LearnDash supports common hosts such as YouTube, Vimeo, Wistia and self-hosted video files, but private links, unusual URL formats or unsupported players stop tracking.

Check the address you pasted:

  • YouTube. Use the normal watch or share link. Make sure the video is public or unlisted, not private.
  • Vimeo. Domain-level privacy must allow your site. Vimeo's privacy options can block embeds on unknown domains.
  • Self-hosted files. Use a direct link to a file format browsers play, such as MP4.
  • Other platforms. Check the LearnDash docs for the current list of supported hosts before relying on them.

LearnDash reads playback through each host's player API. YouTube documents its IFrame Player API and Vimeo documents its Player SDK. If a host blocks those APIs, LearnDash cannot tell when the video ends.

Could a speed plugin be delaying the tracking script?

Yes, delaying, deferring or combining JavaScript can stop LearnDash's video tracking from loading, so the video plays but progress is never recorded.

Speed plugins often delay scripts until the user interacts with the page. LearnDash needs its video script and the host's player API ready when the video starts.

How to test:

  1. Turn off JavaScript delay, defer and combine in your speed plugin.
  2. Clear all caches.
  3. Test the lesson as a student in a private window.

If it now works, add LearnDash's scripts and the player API scripts to your speed plugin's exclusion list. Search the exclusions field for terms like learndash, youtube and vimeo.

Our guide to WP Rocket delay JavaScript exclusions explains how exclusion lists work in a common speed plugin.

Lazy loading for iframes can cause the same problem. Some plugins replace the video iframe with a placeholder image until clicked, which breaks the player API connection. Exclude lesson videos from iframe lazy loading.

Cookie consent tools often block YouTube and Vimeo until a visitor accepts, which stops the player and LearnDash tracking from loading for anyone who has not agreed.

Many consent plugins treat embedded video as a tracking service. They replace the video with a notice until the visitor clicks accept.

Signs this is the cause:

  • Progression works for you but not for new students.
  • The video area shows a message asking for consent.
  • Accepting cookies makes the lesson work.

Fixes include allowing video on lesson pages after consent, using YouTube's privacy-enhanced mode if your consent tool supports it, or self-hosting lesson videos. Our guide on adding a cookie consent banner covers how these tools decide what to block.

Are the display timing and sub-step settings correct?

The display timing option decides whether the video shows before or after the lesson's topics and quizzes are done, which can make the video seem missing or progression seem stuck.

LearnDash offers two main timing choices:

  • Before completed sub-steps. The video shows first, and students watch it before working through topics and quizzes.
  • After completing sub-steps. The video only appears once all topics and quizzes in the lesson are complete.

If students say the video is missing, check whether it is set to appear after sub-steps they have not finished. That is working as designed, but it confuses people.

If the lesson will not complete after the video ends, unfinished topics or quizzes inside it may be the real blocker.

Are the autostart, controls and auto-complete options set up as intended?

Options such as autostart, video controls, pausing when the window loses focus, and auto-complete after the video change how progression behaves, and a wrong combination can look like a bug.

Here is what the common options do:

OptionWhat it doesCommon surprise
AutostartStarts the video when the page loadsBrowsers often block autoplay with sound
Video controlsShows or hides player controlsWithout controls, students cannot pause or seek
Pause on window unfocusedPauses when the student switches tabsLooks like the video stopped by itself
Video resumeRestarts from the last positionStudents think it started in the wrong place
Lesson auto-completionMarks complete when the video endsNeeds the video to play to the very end
Completion delayWaits a set time after the video before completingFeels like nothing happened

Autostart is the one most likely to fail. Browsers block videos that autoplay with sound. MDN's autoplay guide explains the rules browsers follow.

Option names vary a little between LearnDash versions, so match them to what you see on the lesson's Settings tab.

Does the video need to play to the very end?

Yes, LearnDash waits for the player to report that the video has ended, so skipping to the end, stopping early or an end screen that never fires the ended event can stop completion.

Some players let students seek to the end. Depending on your settings, LearnDash may or may not count that.

Things that block the ended event:

  • Students closing the tab a few seconds before the end.
  • Playlists or autoplay of the next video in some players.
  • Custom player skins that change how events are reported.

Test by playing the full video once as a test student. If the Mark Complete button appears or the lesson completes, the setup is fine.

Could a theme, plugin or caching issue be the cause?

Theme templates, plugin conflicts and cached pages can all stop the LearnDash video script from running correctly for students.

Work through these checks:

  • Caching. Do not cache lesson pages for logged-in users. Clear all caches after changes. Our guide on how to clear cache in WordPress covers the main tools.
  • Console errors. Open your browser's developer console on the lesson and look for red errors. Any script error can stop later scripts.
  • Theme test. On a staging copy, switch to a default theme and test again.
  • Plugin test. Disable plugins one at a time, starting with speed, security and consent tools. Our plugin conflict guide explains a safe method.

Also make sure LearnDash itself is up to date. Older versions handled some video hosts differently.

How should you test video progression properly?

Test as a real student in a private window, with a fresh enrollment, because admins and users who already completed the lesson see different behavior.

Admins and group leaders may see the Mark Complete button or have access that students do not. Users who completed the lesson before will not see progression again unless their progress is reset.

A clean testing routine:

  1. Create a test user and enroll them in the course.
  2. Log in as that user in a private window.
  3. Open the lesson and watch the video to the end.
  4. Check whether the button appears or the lesson auto-completes.
  5. Reset the test user's progress from their profile and test again after each change.

If you are still building your course, our guide on how to install LearnDash in WordPress covers setup basics.

Which symptom matches which fix?

Match what students see to the likely cause to save time.

SymptomLikely causeFix
Mark Complete shows straight awayVideo in content, not Video URL fieldMove it to the Video URL field
Video never appearsTiming set to after sub-stepsChange timing or finish sub-steps
Video plays but nothing changesScript delayed or player API blockedExclude scripts, check consent tool
Works for admin, not studentsAdmin sees different controlsTest as a real student
Autostart does nothingBrowser autoplay policyTurn off autostart or mute the video
Vimeo video will not loadDomain privacy settingAllow your domain in Vimeo

Frequently asked questions

Why does the Mark Complete button show before the video ends?

The video is probably embedded in the lesson content rather than added through the Video URL field. LearnDash only tracks the video in that field. Move it there, remove the duplicate from the content and test as a student.

Does LearnDash video progression work with Vimeo?

Yes, Vimeo is supported. The video's privacy settings must allow embedding on your domain, or the player will not load and LearnDash cannot track it. Check the embed and domain options in your Vimeo video settings.

Why does autostart not work on my lessons?

Browsers block videos that autoplay with sound until the user interacts with the page. Autostart may silently fail. Turn the option off, or use a muted video if your host and settings allow it.

Can I use a speed plugin with LearnDash video progression?

Yes, but exclude LearnDash scripts and video player scripts from JavaScript delay and combine options. Also exclude lesson videos from iframe lazy loading. Then clear caches and test as a student.

How do I retest a lesson I already completed?

Reset the test user's course progress from their user profile in the dashboard, or create a fresh test user. Users who already completed a lesson will not see video progression behave as it does for a new student.

Sources

  1. Video Progression LearnDash
  2. YouTube IFrame Player API Google for Developers
  3. Vimeo Player SDK Vimeo Developer
  4. Autoplay guide for media and Web Audio APIs MDN Web Docs

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.