Media Schema

Missing
VideoObject Schema

Your client publishes video content. None of it appears in Google Video results.

Where to find it: Google Rich Results Test > VideoObject > Missing or Google Search Console > Rich Results > Video Errors

What It Is

VideoObject schema communicates the details of a video to Google — its title, description, thumbnail, upload date, and duration — enabling the video to appear in Google Video Search and as a rich result in standard search results with a video thumbnail. Without VideoObject schema, Google may not discover or index the video at all, particularly if it's self-hosted rather than on YouTube. Even for YouTube-embedded videos, VideoObject schema on the host page can increase the likelihood of a video rich result thumbnail appearing in the main search results for the relevant query.

Why It Matters

Video rich results — search listings with a prominent video thumbnail — receive significantly higher click-through rates than text-only results at the same position. For clients who invest in video content, missing VideoObject schema means that investment is receiving less than its full return in search visibility. For self-hosted video content specifically, VideoObject schema is often the difference between Google indexing the video or not finding it at all. Video is increasingly prominent in search results, and schema is the mechanism that connects video content to video-specific indexing systems.

Root Diagnostics

Common Causes

Understanding why this failure occurs is the first step to fixing it permanently.

Self-Hosted Video Without Schema

Video is hosted directly on the site (not YouTube or Vimeo) without any VideoObject schema. Google has no way to discover video metadata — title, duration, thumbnail — without schema or a video sitemap.

Missing thumbnailUrl Property

VideoObject schema exists but the thumbnailUrl property is missing or points to an uncrawlable image. Google requires a crawlable thumbnail image to generate video rich results.

Missing uploadDate Property

The uploadDate property is missing or in the wrong format. Google requires uploadDate in ISO 8601 format and uses it to assess video freshness for time-sensitive video rich results.

No contentUrl or embedUrl

VideoObject schema exists but lacks either contentUrl (direct URL to the video file) or embedUrl (the embeddable player URL). Google needs at least one of these to serve the video in Video Search results.

Interactive Standard Operating Procedure

The Fix Blueprint (Interactive SOP)

Check off each step to monitor your implementation progress live!

Implementation Progress: 0% Completed (0/7)

1. Inventory All Video Content on the Site

Use Screaming Frog to crawl the site and identify all pages containing video elements —

2. Build VideoObject Schema for Each Video

Create VideoObject schema for each video including: name (video title), description (substantive description, not just the title), thumbnailUrl (crawlable image URL), uploadDate (ISO 8601), duration (ISO 8601 duration format, e.g., PT5M30S for 5 minutes 30 seconds).

3. Add contentUrl for Self-Hosted Videos

For videos hosted directly on the site, add contentUrl pointing to the direct video file URL. Also add the hasPart property if the video is segmented into chapters. Google uses contentUrl to index self-hosted video content.

4. Add embedUrl for Embedded Videos

For YouTube-embedded videos, add embedUrl: https://www.youtube.com/embed/VIDEO_ID. For Vimeo, add the Vimeo embed URL. This helps Google associate the embed on your page with the video in its video index.

5. Create a Video Sitemap

In addition to VideoObject schema, create an XML video sitemap listing all video pages with their metadata. Submit it to Google Search Console. A video sitemap is particularly important for self-hosted video discovery.

6. Add Thumbnail Image That Meets Requirements

The thumbnailUrl image must be at least 60px wide and in a 16:9, 4:3, or 1:1 aspect ratio. Images that are too small, wrong aspect ratio, or uncrawlable will cause VideoObject schema to be rejected.

7. Validate and Submit to Search Console

Run video pages through the Rich Results Test. Confirm VideoObject schema is detected with all required fields. Submit the video sitemap to Search Console. Check the Rich Results report for Video status over the following 2–4 weeks.

Tools

Google's Rich Results Test
Free (search.google.com/test/rich-results) | Tests VideoObject schema and shows which required properties are missing or incorrectly formatted
Google Search Console Video Report
Free | Shows indexed video pages, VideoObject schema errors, and video indexing status across the full site
Screaming Frog SEO Spider
Free up to 500 URLs / Paid | Identify all pages containing video elements and check for existing VideoObject schema presence

Time to Fix

1 hour

To inventory all video pages and audit schema

Hours

Per video or template-based for CMS video pages

Pro Tip

Always include duration in ISO 8601 format — it's required for video rich results.

The duration property is one of the most commonly missing VideoObject fields and one of the most important. Google requires it for video rich results, and it must be in ISO 8601 duration format — not a plain text string. PT5M30S means 5 minutes and 30 seconds. PT1H means one hour. PT2H15M means 2 hours and 15 minutes. Building the duration calculation into the video publishing workflow — pulling it from the video file metadata — eliminates this error class permanently rather than fixing it video by video.

Missing VideoObject Schema