Thumbnails for Tube Sites: Own Them, Make Them WebP, Pick the Right Frame

Thumbnails are the first thing a visitor sees and the image search engines show next to your result. They are also one of the most neglected parts of most tube sites. Our rule across every site is simple: every thumbnail we publish is our own file, on our own domain, as WebP. Here is why, and how to get there at scale.

Why hotlinked thumbnails fail

When we imported videos with the thumbnail URLs their sources provided, we later found that 84% of those image hosts on one site had died. Image hosts change domains, block hotlinking, or return tiny placeholder images. Every one of those failures is a grey box in your grid and a broken image in search results. If you only hotlink, you don’t control your own front page.

Get your own copy, then convert to WebP

1. Download the image once when the video is imported.
2. Validate it: reject anything smaller than a sensible minimum (a 694-byte “image” is a placeholder, not a thumbnail) and anything that isn’t really an image.
3. Resize to the largest size you display (we use 640 pixels wide) and save as WebP.
4. Serve it from your own domain, with long cache headers.

WebP files are much smaller than JPEGs at the same quality, which matters when a grid shows 48 of them.

Watch out for contact sheets

Some video hosts generate a “splash” image that is actually a grid of 16 small frames. Used as a thumbnail, it looks like noise at grid size. We found more than 200,000 videos using such sheets before we noticed. The fix: prefer a host’s single-frame image when it has one, and otherwise crop one frame out of the middle of the grid.

When there is no image at all: grab a frame

If you have a direct video file, take a frame yourself:

• Try several points (for example 20%, 40% and 60% into the video). The first second is often black or a logo.
• Reject frames that are too dark or too flat (low variation); try the next point.
• Only read as much of the file as you need; there is no need to download the whole video.

Running it at scale without hurting yourself

Converting hundreds of thousands of thumbnails taught us a few operational lessons:

• Save progress as you go. Our first job saved its results only at the very end, got killed by its time limit before reaching the end, and redid the same work every hour. Work in batches and record each batch immediately.
• Be gentle with image hosts. At 32 parallel requests one host answered most of them with errors; at 6 it served them fine.
• Retry soon on temporary errors, much later on real failures. A host timeout is worth retrying in a few hours; “no image exists” isn’t worth retrying for a week.
• Accept a floor. A few percent of videos may have no image anywhere. Decide what you show for those rather than hammering dead hosts forever.

Thumbnails and search

• Use absolute URLs for thumbnails in your video structured data and video sitemaps; relative URLs make the entry ineligible.
• Give thumbnails meaningful alt text (the video title is fine).
• Keep the same thumbnail URL over time; changing it constantly makes search engines re-fetch images unnecessarily.