How to Fix Missing Video Thumbnails (Poster & thumbnailUrl)

Your audit flagged pages that use self-hosted HTML5 <video> elements without a thumbnail. Each of these videos has no poster attribute, and the page has no VideoObject structured data to supply one. By the end of this guide, every self-hosted video will have a poster image, and your main videos will have VideoObject markup with a crawlable thumbnailUrl.

By Updated ⏱ 20 minutes🎯 Beginner● Low impactContent
Illustration: Video thumbnails specified fix guide
CONTENT · FIX GUIDE Video thumbnails specified IMPACTEFFORT TIME20 minutes LEVELBeginner

Why it matters

Google needs a thumbnail before it will show a video rich result or list a page in the Videos tab. Without one, the page usually appears as a plain blue link. It also loses the video badge and preview image that tend to attract clicks.

Visitors are affected too: a <video> without a poster shows a black or blank box until the file loads, which looks broken on slow connections. AI answer engines and link previews also use VideoObject data to describe and cite video content, so missing thumbnails reduce how often your videos are picked up.

✕Before<video src="/media/product-demo.mp4"controls></video> with no posterattribute and no VideoObject JSON-LD✓After<video src="/media/product-demo.mp4"poster="/media/product-demo-poster.jpg"controls></video> plus a VideoObject

What you need

Edit access to the page templates or CMS editor for the flagged pages
The video files (or a frame grab of each one) to make thumbnail images
ffmpeg or any image editor to export a JPG/WebP frame (optional)
Google's Rich Results Test (search.google.com/test/rich-results)

Step-by-step fix

1

List every self-hosted video on the flagged pages

Open each URL from the audit report. View the page source with Ctrl+U (Cmd+Option+U on Mac) and search for <video. Count the <video tags and the poster= attributes.

The page passes only when every video has a poster, or when the page carries VideoObject structured data. YouTube and Vimeo iframes are not counted because those players supply their own thumbnails.

Pro tip: Background and hero videos (autoplay muted loop) count too. They are the ones most often missing a poster.
2

Create a thumbnail image for each video

Export a representative frame from each video, not the first black frame. Use at least 1280×720 to match the video's aspect ratio. Save it as JPG, PNG or WebP.

Google accepts those formats, and the image must be at least 60×30 px. Upload it to a public URL on your site, such as /media/.

text
ffmpeg -ss 00:00:04 -i product-demo.mp4 -frames:v 1 -vf scale=1280:-2 -q:v 2 product-demo-poster.jpg
Pro tip: Pick a frame that shows the subject clearly. This image becomes the preview in search results and link shares.
3

Add a poster attribute to every <video> tag

Add poster with the image URL to each <video> element. This alone satisfies the check for that video. It also stops the empty black box from showing before playback.

Add preload="metadata" so the browser doesn't download the whole file just to render the page.

html
<video controls preload="metadata" width="1280" height="720"
  poster="https://example.com/media/product-demo-poster.jpg">
  <source src="https://example.com/media/product-demo.mp4" type="video/mp4">
</video>
Pro tip: Set width and height (or a CSS aspect-ratio) so the poster doesn't cause layout shift.
4

Add VideoObject markup for the page's main video

Where the video is the main content of the page, add a VideoObject JSON-LD block in the <head> or body. Google requires name, thumbnailUrl and uploadDate. Add description and contentUrl (the direct file URL) for self-hosted files.

Use embedUrl instead only for third-party players. For a page with several videos, add one VideoObject per video inside a JSON array.

html
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "Example Co product demo",
  "description": "A 2-minute walkthrough of setting up the Example Co dashboard.",
  "thumbnailUrl": "https://example.com/media/product-demo-poster.jpg",
  "uploadDate": "2026-03-12T08:00:00+00:00",
  "duration": "PT2M10S",
  "contentUrl": "https://example.com/media/product-demo.mp4"
}
</script>
Pro tip: Use the same image for poster and thumbnailUrl so search previews match what visitors see on the page.
5

Make sure Googlebot can fetch the thumbnail

Open the thumbnail URL in a private window. It should load with a 200 status and need no login. txt doesn't block the folder, for example Disallow: /media/ or Disallow: /wp-content/uploads/.

txt as well.

text
curl -I https://example.com/media/product-demo-poster.jpg
6

Test the pages and re-run the audit

Paste each fixed URL into Google's Rich Results Test. Confirm it detects a valid Video item with no errors on thumbnailUrl. View the source again and confirm the number of poster= attributes matches the number of <video tags.

Then re-run the audit so the flagged pages clear.

Pro tip: In Search Console, open Indexing → Video pages after Google recrawls the pages. Use URL Inspection → Request indexing to speed this up.

Platform-specific notes

WordPress

In the block editor, select the Video block. In the right sidebar under Settings, click **Poster image → Select** and pick an image from the Media Library. This writes the poster attribute for you. Cover blocks that use a video background have no poster option, so add VideoObject JSON-LD through your SEO plugin's schema settings (Yoast, Rank Math and AIOSEO all support Video schema on paid tiers) or through a Custom HTML block.

Shopify

Videos uploaded to Files or product media and rendered with the `video_tag` Liquid filter get a poster automatically from the video's preview image. Check custom sections that hard-code `<video src="{{ ... }}">`. Switch them to `{{ video | video_tag: image_size: '1280x', controls: true }}`, or add `poster="{{ video.preview_image | image_url: width: 1280 }}"` by hand. Add JSON-LD in the relevant section or in theme.liquid via Online Store → Themes → Edit code.

Next.js

In JSX, add the prop `poster="/media/demo-poster.jpg"` to each <video>. Render the JSON-LD in a script tag with `type="application/ld+json"` and `dangerouslySetInnerHTML={{ __html: JSON.stringify(videoSchema) }}` in the page or layout component. Don't use next/image for posters, because the poster must be a plain URL string.

Webflow

For the native Video element (an embed) and Background Video, Webflow handles the preview image. Custom <video> tags placed in an Embed element need the poster attribute added by hand. Add VideoObject JSON-LD in Page Settings → Custom Code → Inside <head> tag. Use CMS fields for name, thumbnailUrl and uploadDate on collection templates.

Wix

Wix Video and the Video Player element use Wix's own player and cover image. Set the cover in the element's Settings → Change Cover. Only videos added through the Embed HTML (iframe) element with a raw <video> tag need a manual poster attribute.

Check that it worked

✅ How to verify

  • View the page source and confirm every `<video` tag has a `poster=` attribute pointing to a URL that loads.
  • Run the URL through search.google.com/test/rich-results and confirm a valid Video item with thumbnailUrl detected.
  • Use Search Console URL Inspection → Test live URL → View tested page → HTML to confirm Googlebot sees the poster attributes and JSON-LD.
  • Re-run the audit and check that the 'Video thumbnails specified' check no longer lists the page.

⚠️ Common mistakes

  • Using the video's first frame when it's black or a fade-in, which produces a blank thumbnail in search results.
  • Pointing thumbnailUrl or poster to an image blocked by robots.txt, behind a login, or on a signed CDN URL that expires.
  • Copying a VideoObject template with `embedUrl` set to a YouTube placeholder for a self-hosted file. Use `contentUrl` with the real .mp4 URL instead.
  • Adding a poster to one video on a page with several videos. Each <video> tag needs its own poster unless the page has VideoObject markup.

Is this still an issue on your site? Run a free audit — ZORO checks this and 294 other SEO, AI-visibility, accessibility and security signals, with fixes for your platform.

Check my site free

FAQ

What is the poster attribute on an HTML video?

`poster` is an attribute of the <video> element that sets the image shown before the video plays. Example: `<video poster="/thumb.jpg" src="/clip.mp4">`. Without it, browsers show a blank box or the first frame once it loads.

Do I need VideoObject schema if I already have a poster image?

Not for this check: a poster on every video is enough. Even so, VideoObject markup with thumbnailUrl, name and uploadDate gives Google explicit data for video rich results. It's worth adding for the main video on a page.

Why isn't my video showing a thumbnail in Google results?

Since 2023, Google mainly shows video features when the video is the main content of the page. A video in a sidebar or hero background rarely qualifies. Also check that the thumbnail URL is crawlable and that Search Console's Video pages report shows the page as indexed.

Do YouTube or Vimeo embeds need a thumbnail?

No. Embedded players supply their own thumbnails, and this check only looks at self-hosted <video> tags. You can still add VideoObject markup with embedUrl to help Google tie the video to your page.