Troubleshooting
WordPress Video Not Working on Mobile: Causes and How to Fix It

Short answer
WordPress videos often fail on mobile because of an unsupported codec, autoplay rules, missing server range support, or theme and speed plugin settings. Re-encode to H.264 MP4, turn on muted and play inline, and test on a real iPhone and Android phone.
Key takeaways
- H.264 MP4 with AAC audio plays on almost every phone.
- Mobile autoplay needs the video muted and set to play inline.
- iPhones need the server to support byte-range requests.
- Builders often hide videos on mobile through visibility settings.
- Test on real phones, not just desktop emulators.
Why is my WordPress video not working on mobile?
WordPress videos usually fail on mobile because of a codec the phone cannot play, autoplay rules, missing server streaming support, or a theme or speed plugin that hides the player.
Desktop browsers are more forgiving than phones. A video can play perfectly on your laptop and still show a black box, a crossed-out play icon or nothing at all on an iPhone or Android device.
Mobile browsers have stricter rules about autoplay, data use and battery. Themes and page builders also often change or hide videos on small screens to save bandwidth.
Start with the symptom you see, then work through the matching section. This guide covers self-hosted videos, embeds from YouTube or Vimeo, and background videos.
| What you see on mobile | Likely cause | Where to start |
|---|---|---|
| Black box or play icon that does nothing | Unsupported codec such as HEVC | Re-encode to H.264 MP4 |
| Video plays on Android but not iPhone | Server lacks byte-range support | Check server headers |
| Video does not autoplay | Mobile autoplay rules | Mute and add playsinline |
| Video opens full screen unexpectedly | Missing inline playback attribute | Add playsinline |
| Video area is blank or missing | Hidden by theme or builder on mobile | Check responsive visibility settings |
| Embed is cut off or overflows | Fixed width iframe | Use a responsive embed |
| Video works after a long wait | File too large for mobile data | Compress or use a streaming host |
Is the video file in a format phones can play?
The most reliable format for mobile is an MP4 file with H.264 video and AAC audio, because almost every phone and mobile browser can decode it.
Many phones record in HEVC, also called H.265. Some devices play it, but support varies, so a file from your own phone can fail on someone else's.
The fix is to re-encode the video. A free tool such as HandBrake can convert it to H.264 MP4 using a web preset.
MDN's guide to web video codecs explains why the file extension alone does not tell you whether a browser can play it. Two MP4 files can use completely different codecs inside.
After re-encoding, upload the new file and replace the old one in the video block. Then test on both an iPhone and an Android device.
Why does the video play on Android but not on iPhone?
Videos that work on Android but fail on iPhone often point to the server, because Safari on iOS asks for video in small pieces and needs the server to support byte-range requests.
Most web servers support this by default. But some security plugins, CDN settings or custom server rules strip the Accept-Ranges header or return the whole file instead.
You can check by viewing the response headers for the video URL in your browser's developer tools. Look for Accept-Ranges: bytes and a 206 Partial Content response when the video plays.
If the header is missing, ask your host to enable range requests for media files. Moving videos to a CDN or video host also solves it, because they handle streaming properly.
Codec problems also show up on iPhone first, so rule out the format before changing server settings.
Why does the video not autoplay on mobile?
Mobile browsers only allow autoplay when the video is muted, and iPhones also need the video set to play inline, so an unmuted autoplay video simply sits still.
This is a deliberate browser rule to save data and avoid surprise sound. Apple explains it in the WebKit post on video policies for iOS.
In the WordPress video block, turn on Autoplay, Muted and Play inline in the block settings. All three are needed for reliable autoplay on phones.
Even then, autoplay can be blocked. Low power or data saver modes on some phones stop autoplay completely, and there is nothing a website can do about that.
MDN's page on the video element lists the autoplay, muted and playsinline attributes if you add video with custom HTML.
Why does the video open full screen on iPhone?
On iPhones, videos without the playsinline attribute can open in the full screen player as soon as they start, which breaks background videos and short looping clips.
Turn on Play inline in the video block settings. In a page builder, look for a similar option in the video widget.
If you add the video with custom HTML, include the playsinline attribute on the video tag. Without it, iOS may treat the video as something to watch full screen.
This matters most for decorative videos. A hero clip that suddenly takes over the screen is jarring and often makes visitors leave.
Is your theme or page builder hiding the video on mobile?
Yes, many themes and page builders hide videos on phones by default or let you hide them per device, so the video may be turned off rather than broken.
Page builders such as Elementor have responsive visibility settings. A section or widget can be set to show on desktop only, and the video then disappears on mobile.
Background videos are often replaced with a fallback image on mobile to save data. If you expected the video, check the background settings for a mobile option.
Our guide on WordPress background video not working on mobile covers that case in detail.
For general layout problems on phones, see how to fix WordPress mobile view.
Is a speed plugin breaking the mobile player?
Speed plugins can break mobile video by lazy loading the player, delaying the scripts it needs, or serving a separate mobile cache that still holds an older, broken version.
Lazy loading for iframes and videos is useful, but some implementations never trigger on mobile. The player stays as a blank placeholder.
Script delay features wait for user interaction before loading JavaScript. A video player that depends on those scripts may not appear until the visitor taps or scrolls.
Test by pausing optimization features one at a time and clearing the cache. If you use WP Rocket, our guide on WP Rocket mobile cache not working explains the separate mobile cache.
Clear every cache layer after each change, including your plugin, server and CDN. Our guide on how to clear cache in WordPress covers each one.
Why is the embedded video broken on mobile?
Embedded videos break on mobile when the iframe has a fixed width that overflows the screen, the embed URL is wrong, or the video owner has blocked playback on other sites.
Use the WordPress embed block instead of pasting fixed-size iframe code. The block handles responsive sizing for YouTube, Vimeo and other supported services.
If you must use custom iframe code, remove fixed width and height values or wrap the iframe in a responsive container. Themes that support responsive embeds make this automatic.
Some videos cannot be embedded at all. YouTube lets owners turn off embedding, and its help page on embedding videos explains the settings.
Our guide on WordPress video embed not working goes through other embed problems.
Is the video too large for mobile connections?
Large video files can take so long to load on mobile data that the player looks broken, especially when the file is several hundred megabytes or uses a very high bitrate.
Phones on cellular connections download far more slowly than a desktop on broadband. A 4K file meant for desktop is often too heavy for mobile.
Compress the video to a sensible resolution, such as 720p or 1080p, and a moderate bitrate. Most visitors on phones cannot see the difference on a small screen.
For long videos, consider a streaming host. YouTube, Vimeo and similar services adjust quality to each viewer's connection. Our guide on self-hosting videos vs embedding YouTube weighs the trade-offs.
Could mixed content or a CDN rule block the video?
Yes, a video loaded over http on an https page is blocked by mobile browsers, and CDN or hotlink protection rules can also refuse requests from mobile apps or browsers.
Check the video URL in the block or the page source. If it starts with http:// on a secure site, update it to https. Our guide on fixing mixed content warnings explains how to find these links.
Hotlink protection sometimes blocks video files when a request has no referrer, which happens in some mobile browsers and in-app browsers. Add your own domain and allow empty referrers, or exclude video files from the rule.
If the video is served through a CDN, test the direct file URL on your phone. If it fails there too, the problem sits with the CDN settings rather than WordPress.
How do you test video on mobile properly?
Test on at least one real iPhone and one real Android phone, on both Wi-Fi and mobile data, because desktop device emulators do not copy mobile codec and autoplay rules.
Browser developer tools can resize the page to phone dimensions. That is useful for layout, but it still uses your desktop browser's video engine.
Use a private window on each phone to avoid cached versions. Also try the page inside apps such as Facebook or Instagram, since their in-app browsers behave differently.
Write down what fails and where. A pattern, such as iPhones only or mobile data only, points straight to the cause. If videos also fail on desktop, start with our main guide on WordPress videos not working.
Frequently asked questions
Why does my video show a black screen on iPhone?
A black screen usually means the iPhone cannot decode the video's codec or the server is not handling streaming requests properly. Re-encode the file to H.264 MP4 with AAC audio, upload it again, and check that the server returns partial content responses for the file.
Can I force a video to autoplay with sound on mobile?
No. Mobile browsers block autoplay with sound to protect data use and avoid surprise noise. You can autoplay a muted video set to play inline, and visitors can turn the sound on themselves. Low power or data saver modes may still block it.
Why does my WordPress video work on Wi-Fi but not mobile data?
Large files can load too slowly on mobile data, making the player appear broken. Some carriers or data saver modes also limit video. Compress the video to a lower resolution and bitrate, or host it on a streaming service that adjusts quality automatically.
Should I host videos on YouTube instead of WordPress?
For long or high-traffic videos, a streaming host is usually better on mobile because it adjusts quality to each connection and handles playback rules. Self-hosting suits short clips and background videos where you want full control and no outside branding.
Sources
- Web video codec guide MDN Web Docs
- The Video Embed element MDN Web Docs
- New video policies for iOS WebKit
- Video block WordPress.org Documentation
- Embed videos and playlists YouTube Help
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.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


