Shaka Error 4000 (web_4000): The Plain-English Fix for UNABLE_TO_GUESS_MANIFEST_TYPE

You hit play, the screen goes dark, and instead of your video you get web_4000 or Shaka error 4000. Frustrating— but harmless, and usually quick to fix. This guide explains what the error actually means in everyday language, then walks you through the fixes twice: once for regular viewers, and once for developers wiring up Shaka Player.

Error 4000 at a glance

How Shaka decides — and where 4000 happens

Before any video plays, Shaka has to answer one question: “What kind of stream is this?” It checks the link, then the server’s headers. If both come back blank, it gives up with error 4000.

What triggers web_4000

Disney+ Error Code 73 in Australia: Fast Fix (2026)

For viewers
Fix it without touching code

If you’re just trying to watch something, the problem is almost always the link, not your device. Try these in order:

For developers
Fix it at the source

Shaka’s own docs spell out three official fixes: rename the manifest to a known extension, send a recognizable
Content-Type, or accept a HEAD request so the type can be sniffed. Here’s how that plays out in practice.

1 · Send the right Content-Type header

Configure your server (or CDN) so the manifest responds with the correct MIME type:

# DASH manifest
Content-Type: application/dash+xml

# HLS manifest
Content-Type: application/vnd.apple.mpegurl

2 · Tell load() the type directly

If you can’t change the server, pass the MIME type as the third argument so Shaka skips the guessing step entirely:

// DASH
await player.load(manifestUri, null, 'application/dash+xml');

// HLS
await player.load(manifestUri, null, 'application/vnd.apple.mpegurl');

3 · Use the final URL, not a redirect

A very common 4000 trap: the link redirects to the real .mpd/.m3u8, and the redirect strips the type clue. Resolve it to the final manifest URL and load that one directly.

4 · Confirm it’s actually a supported format

Shaka natively handles DASH and HLS only. A bare MP4, a WebM, or Smooth Streaming (.ism) won’t be auto-detected. Either repackage to DASH/HLS or load the MP4 directly with its MIME type.

Manifest cheat sheet

Frequently asked questions

Bottom line

Error 4000 isn’t a dead end — it’s the player saying “I don’t know what this stream is.” Viewers: refresh, switch browsers, and check that the link still works. Developers: send the right Content-Type, pass the MIME type to load(), and avoid redirects that hide the manifest. Do that and web_4000 disappears for good.