Why maxresdefault is missing on some videos

You paste a link, ask for the 1280 × 720 thumbnail, and get nothing back — or worse, a grey rectangle 120 pixels wide. The video plays fine. The thumbnail is clearly visible on YouTube. So where is the file?

The short answer

YouTube generates maxresdefault.jpg only when the source upload was 720p or higher. If the video was uploaded at 480p, 360p, or anything below the 720p threshold, that derivative was never created, and it will never be created retroactively. The file is not hidden, throttled, or region-locked. It does not exist.

Why the placeholder is 120 × 90

Requesting a file that does not exist returns a grey placeholder image rather than an HTTP error. YouTube's image servers respond with a 200 status and a small default graphic. From a script's point of view the request succeeded perfectly, which is why so many thumbnail tools quietly hand you a useless file instead of a clear message.

The workaround is to measure rather than trust the status code. If the returned image is 120 pixels wide and you asked for a file that should be 1280 or 640 wide, the file is missing.

The cases where it goes missing

Old uploads

Anything uploaded before HD was common on YouTube is a likely candidate. A 2009 video uploaded at 360p has no maxres derivative and never will, no matter how many times the uploader changes the custom thumbnail afterwards.

Low-resolution re-uploads

Channels that re-upload compressed footage — archive channels, clip accounts, mirrors — often push files below the threshold. The custom thumbnail they set might be a crisp 1280 × 720 image, but the derivative ladder is built from the video's properties, so it still stops short.

Some live streams

Streams archived at a lower resolution, or streams that ended abruptly, sometimes end up without the maxres derivative. This is inconsistent enough that it is worth checking rather than assuming.

Very recent uploads

This one is temporary. Processing takes time, and a video published minutes ago may not have finished generating every derivative. If the video is new, waiting an hour and checking again is worth doing before concluding the file is permanently absent.

What the uploader can and cannot fix

If it is your own video, replacing the custom thumbnail with a 1280 × 720 image does not regenerate the maxres derivative on its own. The derivative is tied to the video processing, so the reliable fix is re-uploading the video at 720p or higher. For an established video with view history and comments, that trade is rarely worth making just to gain a larger thumbnail file.

What to use instead

When maxres is unavailable, work down the ladder. sddefault at 640 × 480 is the next real file; crop 60 pixels off the top and bottom to recover a clean 640 × 360 image. If that is missing too, hqdefault at 480 × 360 always exists, and cropping the same way gives you 480 × 270.

Do not upscale a small thumbnail and expect it to hold up. The artefacts in a 480-wide JPEG are baked in, and enlarging them makes the compression blocks more visible, not less. If you need a large image of a video that has no maxres file, taking a clean screenshot from the video at full playback resolution usually gives a better result than resizing the thumbnail.

Checking before you commit

If you are collecting thumbnails in bulk — for a competitive board, a study, or an archive — check availability first rather than downloading and sorting through the results afterwards. The downloader on the front page tests all five files for a video and marks the missing ones explicitly, so you know within a second whether the large file exists.