help

Video not autoplaying in TikTok in-app browser — fix

the linkboo team·2 min read·updated Mon Jun 01 2026 17:00:00 GMT-0700 (Pacific Daylight Time)
On this page

Mobile webviews — including TikTok's — block video autoplay by default unless the video is muted, marked playsinline, and served in a format the webview's media stack accepts. A video that autoplays correctly in Safari may not autoplay in TikTok's in-app browser. Five steps to make it work.

Fix steps

  1. Add muted, playsinline, and autoplay attributes to the <video> tag. All three are required. Without muted, mobile browsers block autoplay. Without playsinline, iOS opens the video full-screen on play instead of inline. Without autoplay, it never starts.

    <video src="..." muted playsinline autoplay loop preload="auto"></video>
    
  2. Confirm the codec. TikTok's iOS webview uses WebKit and supports H.264 reliably; HEVC support is patchy. Android TikTok webview supports H.264 and VP9 but not all AV1 streams. Encode in H.264 baseline profile for maximum compatibility.

  3. Check the MIME type and file extension. The server must return Content-Type: video/mp4 for .mp4 files. A wrong content-type or application/octet-stream prevents the webview from recognizing the file as playable.

  4. Avoid third-party players that require parent-window context. YouTube embeds, Vimeo embeds, and Wistia embeds sometimes refuse to autoplay inside webviews because they detect the webview as non-standard. Self-hosted MP4 is more reliable.

  5. Test with a low-bitrate fallback. TikTok's webview on cellular connections sometimes silently fails to load videos above a certain bitrate. Provide a <source> ladder with a 720p H.264 fallback under 2 Mbps for reliable playback on cellular.

If autoplay still fails, test by triggering play on user interaction instead — a tap-to-play poster image. iOS specifically blocks programmatic play in some webview contexts but allows it on user gesture.

Still not working?

If the video plays in Safari but not in the TikTok webview consistently, route the viewer out of the webview to their default browser before the page loads. The video then plays in Safari or Chrome with their usual autoplay rules.

Want the full diagnosis? See TikTok in-app browser media handling explained.

Need landing pages whose video plays reliably from TikTok? Start free on linkboo →

Stop losing the click after the tap.

linkboo escapes the in-app browser so your real page loads — fast.

Start for free →