Tutor LMS Video Not Playing

Updated March 11, 2026 • Expert Guide • Prime AI Tech Solutions

Looking for the best solutions? Compare top options and get expert advice tailored to your needs.

Explore Top Recommendations ›

Troubleshooting Tutor LMS: A Comprehensive Guide to Resolving Video Playback Issues

Tutor LMS is a powerful and flexible WordPress LMS plugin, empowering countless educators and organizations to deliver engaging online courses. However, one of the most frustrating issues course creators and students can encounter is when course videos fail to play. A non-functional video player can severely disrupt the learning experience, leading to student dissatisfaction and increased support requests. This article serves as an expert-level, comprehensive guide to diagnosing and resolving video playback problems within your Tutor LMS setup, providing actionable steps and deep insights to get your courses back on track.

Understanding the Core Problem: Why Videos Fail to Play in Tutor LMS

Video playback issues are rarely due to a single, isolated factor. Instead, they often stem from a complex interplay of client-side, server-side, plugin, and configuration challenges. Identifying the root cause requires a systematic approach. Here's a breakdown of the primary categories where problems typically arise:

  • Client-Side Factors: Browser compatibility, outdated software, internet connection, local caching.
  • Video Source & Hosting: Incorrect embed codes, privacy settings, file format incompatibility, server resource limitations for self-hosted videos, CDN misconfigurations.
  • Tutor LMS & WordPress Configuration: Incorrect plugin settings, theme conflicts, permalink issues, outdated core software.
  • Plugin Conflicts: Other WordPress plugins interfering with Tutor LMS's video player or media handling.
  • Server-Side Issues: PHP version, memory limits, MIME types, CORS policies, firewall rules, .htaccess misconfigurations.
  • Video Encoding & Optimization: Videos not properly encoded for web streaming, resulting in playback errors or poor performance.

By systematically addressing each of these potential areas, you can pinpoint the exact cause of your video playback woes.

Tutor LMS Video Playback Troubleshooting Flowchart

Step-by-Step Guide: Diagnosing and Resolving Tutor LMS Video Playback Issues

1. Initial Browser & Client-Side Checks

Always start with the simplest solutions. Many issues are localized to the user's environment.

  1. Clear Browser Cache & Cookies: Stale data can often interfere with website functionality. Instruct users (and try yourself) to clear their browser's cache and cookies.
  2. Try Incognito/Private Mode: This mode typically disables extensions and prevents caching, offering a clean slate for testing.
  3. Test Different Browsers: If a video plays in Chrome but not Firefox, it points to a browser-specific issue (e.g., a browser extension).
  4. Disable Browser Extensions: Ad-blockers, privacy extensions, or other plugins can sometimes block video players or embed scripts.
  5. Check Internet Connection: A slow or unstable connection can prevent videos from loading or streaming properly. Test with a different network if possible.
  6. Update Browser: Ensure the browser is updated to the latest version.

2. Verify Video Source & Hosting

The source of your video content is a critical component. Misconfigurations here are common culprits.

  • For Self-Hosted Videos (WordPress Media Library):
    • File Path Accuracy: Double-check that the video file path in Tutor LMS is absolutely correct.
    • File Permissions: Ensure the video files and their containing folders have correct read permissions (e.g., 644 for files, 755 for directories). Incorrect permissions can prevent the web server from serving the files.
    • Supported Formats: Tutor LMS generally supports MP4, WebM, and Ogg. MP4 (H.264 codec) is the most widely compatible. Ensure your videos are in a web-friendly format.
    • Server Resources: Self-hosting videos, especially high-resolution ones, consumes significant server bandwidth and CPU. If your server is under-resourced or oversold, video streaming will suffer. Check your hosting provider's resource usage statistics.
    • MIME Types: Ensure your server's .htaccess or Nginx configuration includes correct MIME types for video files (e.g., video/mp4 for .mp4 files).
  • For External Hosting (YouTube, Vimeo, AWS S3, Bunny.net, Wistia, etc.):
    • Embed Code Correctness: Copy the exact embed URL or code provided by the external service. Paste it directly into the Tutor LMS video source field.
    • Privacy Settings: Ensure the video is set to "Public" or "Unlisted" (if using services like YouTube/Vimeo). "Private" videos will not play.
    • Domain Restrictions: Some services (e.g., Vimeo Pro) allow you to restrict video playback to specific domains. Verify your website's domain is allowed.
    • API Keys/Embed Tokens: If using a more advanced integration (e.g., Wistia's API or certain AWS configurations), ensure API keys or embed tokens are correctly configured and valid.
    • CDN Integration Issues: If using a CDN with S3 or other object storage, verify the CDN distribution is correctly configured and has invalidated its cache if you've made recent changes.

3. Tutor LMS & WordPress Configuration

Plugin and core platform settings can often be the source of conflict.

  1. Tutor LMS Video Player Settings:
    • Navigate to Tutor LMS > Settings > Course > Course Builder > Video Source. Ensure the selected video source (e.g., HTML5 Player, YouTube, Vimeo, External URL) matches how you're adding videos.
    • When adding a video to a lesson, confirm the "Video Source" dropdown in the lesson editor is correctly set (e.g., "YouTube" for a YouTube URL, "HTML5 Player" for a self-hosted MP4).
  2. WordPress Permalinks Flush: Sometimes, WordPress routing issues can affect how media is served. Go to Settings > Permalinks and simply click "Save Changes" without making any modifications. This flushes the permalink rules.
  3. WordPress Site Health: Check Tools > Site Health for critical issues or recommended improvements that might be impacting media.
  4. Theme Conflicts: A poorly coded theme can interfere with scripts or styles. Temporarily switch to a default WordPress theme (e.g., Twenty Twenty-Four) and test video playback. If it works, your theme is the culprit.
WordPress Plugin Conflict Resolution Interface

4. Plugin Conflicts

This is one of the most common causes of unexpected behavior in WordPress.

  1. Deactivate All Other Plugins: The most definitive way to check for conflicts is to deactivate all plugins except Tutor LMS (and Tutor LMS Pro, if applicable). Test video playback.
  2. Reactivate One by One: If videos play after deactivating all plugins, reactivate them one by one, testing video playback after each activation. This will help you identify the conflicting plugin.
  3. Common Conflicting Plugin Types:
    • Caching Plugins: Clear all caches (plugin, server, CDN) after making changes. Disable temporarily for testing.
    • Security Plugins: Firewalls or content scanners might block video embeds or scripts.
    • Media/Optimization Plugins: Plugins that lazy-load images/videos, optimize media, or convert formats can sometimes interfere.
    • Page Builders: While generally compatible, some specific elements or settings might cause issues.

5. Server-Side Diagnostics

These issues often require access to your hosting control panel or assistance from your host.

  • PHP Version Compatibility: Ensure your server is running a PHP version compatible with Tutor LMS (check Tutor LMS documentation for current requirements, typically PHP 7.4 or higher). Outdated PHP can cause silent failures.
  • Memory Limit & Execution Time: Increase PHP memory_limit (e.g., to 256M or 512M) and max_execution_time (e.g., to 300 seconds) in your php.ini or wp-config.php file.
  • mod_rewrite Module: For proper permalinks and routing, Apache's mod_rewrite module must be enabled.
  • CORS Headers: If videos are hosted on a different domain or subdomain, Cross-Origin Resource Sharing (CORS) headers might be needed to allow your website to access them. This is particularly relevant for S3 or other object storage.
  • Firewall/Security Rules: Server-level firewalls (e.g., ModSecurity) can sometimes block specific video requests or embedded content. Check your server logs for blocked requests.
  • .htaccess File Issues: A misconfigured .htaccess file can lead to 500 errors or prevent files from being served. Back it up and try resetting it to WordPress default rules.

6. Video Encoding & Optimization

Poorly optimized videos can lead to playback issues, buffering, or non-loading scenarios.

  • Proper Encoding: Ensure videos are encoded using H.264 for MP4, with a suitable bitrate for web streaming. Use tools like HandBrake for optimal compression and web compatibility.
  • Progressive Download/Streaming