Storefront Fix Guide
Fix common Shopify storefront problems fast

Why do Shopify product videos not play on mobile?

Usually one of three things: the video never loads because of how the theme handles it, the phone blocks autoplay the way the desktop did not, or the file itself is too heavy or in a format the phone dislikes. Work through it in order: check whether the video element exists on the page, check the autoplay and mute settings, then check the file. Most video failures are settings, not code.

First, find out what "not playing" means

The symptom narrows the cause. A black rectangle where the video should be usually means the video never loaded: wrong file, broken URL, or the theme failed to render it. A still thumbnail that never starts means the file loads but playback never triggers: autoplay settings or a phone policy blocking it. A video that starts and then stutters or stalls is a file problem: too heavy for the connection or the device.

Reproduce it on a real phone, not just a desktop browser resized. Mobile browsers enforce autoplay and data-saver policies that desktops do not, so a video that plays fine on desktop can be completely dead on a phone for policy reasons alone.

Autoplay is blocked unless the video is muted

This is the single most common cause. Mobile browsers block autoplay for any video with sound. A product video set to autoplay with audio will sit as a still frame on every phone. The fix is to mute the video: muted autoplay is allowed. In the theme customizer, look for the autoplay and mute toggles on the video section and make sure mute is on.

Check this in the theme settings before touching code. Many merchants upload a video, enable autoplay, and never notice the mute toggle sitting right next to it. The desktop preview plays with sound, the phone shows a thumbnail, and the bug report writes itself.

The theme may not load video on mobile at all

Some themes and page-builder sections load a static image on mobile instead of the video, either as a performance choice or because the section was never finished for mobile. Inspect the page on a phone-sized viewport and look at what the theme actually rendered: if there is no video element in the DOM, no setting will fix it, because the theme decided not to show video there.

Also check for apps that interfere. Video popup apps, lazy-load apps, and anything that rewrites media sections can swallow the video element on mobile while leaving desktop intact. Disable recently added apps one at a time and retest. The app conflict is the classic "it worked last week" explanation.

File problems: size, format, and hosting

Phones are less forgiving of heavy files. A 50MB video that eventually plays on desktop wifi will time out on a phone. Keep product videos short, compressed, and ideally under 10MB. H.264 MP4 is the safe format: it plays everywhere. Newer codecs save space but can fail on older phones.

Where the file is hosted matters too. Videos uploaded to Shopify Files play from the CDN and generally work. Videos hotlinked from elsewhere can fail from hotlink protection or slow hosts. And if the video URL changed, through a file rename or a re-upload, the theme section may still point at the old URL: re-select the file in the customizer.

The checklist, in order

One, reproduce on a real phone and classify the symptom: never loads, loads but never starts, or starts and stalls. Two, check autoplay and mute in the theme customizer. Three, inspect whether the video element exists on mobile at all. Four, disable recent apps and retest. Five, check the file: size, format, and whether the URL is current. Six, only then consider theme code, and only in a duplicated theme.

The video plays on desktop but not on my iPhone. Why?
Almost always the muted-autoplay rule: iPhones block autoplay with sound. Mute the video in the theme settings and it will autoplay. If it still fails, check that the theme renders a video element on mobile viewports.
Should I just use a GIF instead?
No. GIFs are far heavier than video for the same content and have no playback controls. A compressed muted MP4 is smaller, smoother, and more accessible.
Do I need the video to autoplay at all?
Not necessarily. A click-to-play video with a good poster frame converts fine and sidesteps every autoplay policy. If autoplay keeps causing trouble, a poster frame plus tap-to-play is the robust option.