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.

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.
What you need
Step-by-step fix
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.
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/.
ffmpeg -ss 00:00:04 -i product-demo.mp4 -frames:v 1 -vf scale=1280:-2 -q:v 2 product-demo-poster.jpg
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.
<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>
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.
<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>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.
curl -I https://example.com/media/product-demo-poster.jpg
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.
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 freeFAQ
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.
How to Fix Heavy YouTube and Vimeo Embeds with Facades
How to Fix Missing VideoObject Schema on Video Pages
How to Fix Missing Video Entries in Your XML Sitemap
How to Fix Page Content That Doesn't Match Its Title
How to Fix Thin Content: Expand or Merge Pages Under 300 Words
How to Fix Localisation Quality on Multilingual Pages