Shopify Video Not Playing?
Causes and Fixes (2026)

If you've uploaded a video to your Shopify store and it isn't playing — on PDPs, the homepage, or anywhere else — the cause is almost always one of seven things. This guide walks through each in order of frequency so you can fix it quickly.

Quick diagnostic

Before fixing anything, answer three questions:

1. Which video isn't playing? Native upload, theme-section video, app-embedded, or custom-code embedded?
2. What does "not playing" mean? Black screen, error message, no video at all, or playing on desktop but not mobile?
3. Where is it not playing? PDP only, every page, mobile only, certain browsers only?

The answers narrow the cause fast.

Cause 1: Unsupported file format (~30% of cases)

Shopify natively supports MP4, MOV, and M4V. Anything else won't play.

The fix: If you have a .avi, .wmv, .flv, .webm, or .mkv file, convert it to MP4 first. HandBrake (free, Mac/Windows) handles this in two clicks. Recommended export settings: H.264 codec, AAC audio, 1080p max resolution for PDP video.

How to confirm: Check the file extension. If it's anything other than .mp4, .mov, or .m4v, this is the issue.

Cause 2: File size over Shopify's limit (~15% of cases)

Shopify caps video uploads at 1 GB per file and recommends staying under 256 MB for performance.

The fix: Compress the video before upload. HandBrake or a free online compressor can get a 30-second 1080p video under 50 MB without visible quality loss. Bitrate target: 5–8 Mbps for 1080p, 2–4 Mbps for 720p.

How to confirm: Right-click the file → Properties (or "Get Info" on Mac) → check file size. If it's over 256 MB, compress it.

Cause 3: Autoplay blocked by the browser (~20% of cases)

Modern browsers block autoplay unless the video is muted. If you set a video to autoplay with sound on, it won't auto-start — but it will still play when the user clicks.

• Set the video to muted if you want it to autoplay
• If you're using an iframe embed, add &mute=1 to the URL
• If you're using app-based embedding, find the autoplay setting and ensure "muted" is enabled

How to confirm: If the video plays when you click the play button but not when the page loads, this is autoplay being blocked. It's not a bug — it's the browser enforcing the autoplay-with-sound policy.

Cause 4: Theme conflict or incompatibility (~12% of cases)

Older themes — or heavily customised newer ones — sometimes don't include the JavaScript or section types needed to render video correctly.

Fix paths in order:

1. Test on a default theme. In Shopify Admin, duplicate your current theme as a backup, then temporarily switch to Dawn. Re-test the video. If it plays on Dawn but not your custom theme, the issue is theme-specific.
2. Check theme updates. Open Online Store → Themes → [your theme] and look for available updates. Themes more than 12 months out of date are a common source of video issues.
3. Inspect the browser console. Open the page in Chrome, right-click → Inspect → Console tab. Look for JavaScript errors mentioning video, media, or the player. The error usually points to the file.

When this is the cause: The video element appears in the page source (visible in DevTools) but doesn't render visibly. That's a CSS/JS conflict, not a file problem.

Cause 5: App conflict (~10% of cases)

If you have multiple apps that touch video — a review app, a video app, a page builder, a popup app — they can collide. The common symptom is video playing fine in some placements but not others.

1. Identify all apps that touch video (Settings → Apps and sales channels)
2. Temporarily disable one at a time, re-testing playback after each
3. The app that fixes playback when disabled is the conflict source

Cause 6: Slow or broken video URL (~8% of cases)

For URL-embedded videos (YouTube, Vimeo, or external CDN), the video can fail simply because the source URL is broken or slow to respond.

• Click the original video URL directly in a browser. If it doesn't play there either, the source is the problem.
• Check that the YouTube/Vimeo video is set to public, not private or unlisted — Shopify embeds may fail on private videos.
• Try replacing the URL with a different working video temporarily to confirm it's a source-URL issue, not a Shopify issue.

Cause 7: Mobile-specific playback failure (~5% of cases)

Sometimes video plays on desktop but not on mobile. Causes:

• iOS Safari Low Power Mode. When iPhones are in Low Power Mode, autoplay videos are blocked even if muted. Users need to tap to play. This isn't fixable from your end.
• Missing playsinline attribute. iOS Safari forces video to play full-screen by default unless you set playsinline on the video element. For custom code embeds this is the fix: <video playsinline autoplay muted loop>.
• Cellular data restrictions. Some users have settings that block autoplay on cellular. Not fixable from your end.

For native Shopify upload and app-based embedding, playsinline is set automatically. Only custom code embeds typically have this issue.

Less common causes

If you've worked through all seven above and the video still doesn't play:

• Browser cache. Hard-refresh the page (Cmd+Shift+R on Mac, Ctrl+Shift+R on Windows) or test in an incognito window.
• Ad blocker or browser extension. Some ad blockers block video players. Test in a clean browser profile.
• Network restrictions. Corporate networks sometimes block video streaming domains. Test on a different network.
• Shopify CDN issue. Rare, but Shopify's CDN can have regional issues. Check status.shopify.com.

When to switch from native upload to an app

If you find yourself debugging video playback regularly, the underlying issue may be that native Shopify video isn't built for the use case you're trying to serve. Switch to an app when:

• You have more than 10 SKUs with video and want consistent playback across all of them
• You need video to lazy-load for page speed — native upload doesn't lazy-load
• You want analytics on which videos drove conversions — native upload provides none
• You want video to be shoppable (tagged for direct add-to-cart) — see our complete guide to shoppable video on Shopify
• You want to surface Instagram or TikTok content on PDPs automatically

For any of these, see our complete guide to embedding video on Shopify for the app-based path.

If you're managing video at scale and finding native Shopify video painful — install Whatmore and skip the file-format, file-size, autoplay-policy, and theme-compatibility issues entirely. Get started free →