Google video structured data

The Google video structured data,
as documented

What Google documents, in its own words. Verified from Google's page on 2026-10-09.

Google's page explains how video markup can influence video results and which properties it needs. This page lists those statements with the exact wording from Google.

What Google says

TopicWhat Google saysSource
What markup influences “you can influence the information that's shown in video results, such as the description, thumbnail URL, upload date, and duration, by marking up your video with VideoObject.” Google docs
Verified 2026-10-09
Where videos appear “Videos can appear in several different places on Google, including the main search results page, Video mode, Google Images, and Google Discover.” Google docs
Verified 2026-10-09
LIVE badge “The LIVE badge can be applied to any public video that is live-streamed for any length of time.”Google says to mark the video with BroadcastEvent. Google docs
Verified 2026-10-09
Key moments “Google Search tries to automatically detect the segments in your video and show key moments to users, without any effort on your part.” Google docs
Verified 2026-10-09
Clip “Specify the exact start and end time to each segment, and what label to display for each segment.”Google describes this for Clip structured data. Google docs
Verified 2026-10-09
Opting out of key moments “To opt out of the key moments feature completely (including any efforts Google may make to show key moments automatically for your video), use the nosnippet meta tag.” Google docs
Verified 2026-10-09
Manual action “If Google detects that some of the markup on your pages may be using techniques that are outside our structured data guidelines, your site may receive a manual action.” Google docs
Verified 2026-10-09
Missing required properties “If you don't include the required properties, Google may not be able to extract any information about the video.” Google docs
Verified 2026-10-09
name “The title of the video. Make sure to use unique text in the name property for each video on your site.”Required property. Google docs
Verified 2026-10-09
thumbnailUrl “A URL pointing to the video's unique thumbnail image file.”Required property. Google docs
Verified 2026-10-09
uploadDate “The date and time the video was first published, in ISO 8601 format.”Required property. Google docs
Verified 2026-10-09
Timezone “We recommend that you provide timezone information; otherwise, we will default to the timezone used by Googlebot.” Google docs
Verified 2026-10-09
contentUrl “This is the most effective way for Google to fetch your video content files.”Recommended property. Google docs
Verified 2026-10-09
embedUrl “If contentUrl isn't available, provide embedUrl as an alternative.” Google docs
Verified 2026-10-09
Watch page “VideoObject structured data must be added to a page where users can watch the video.” Google docs
Verified 2026-10-09
Clip minimum length “The total video duration must be a minimum of 30 seconds.”Google lists this under the Clip and SeekToAction guidelines. Google docs
Verified 2026-10-09
Indexing API “The Indexing API only supports livestream videos.” Google docs
Verified 2026-10-09
Validation “Validate your code using the Rich Results Test and fix any critical errors.” Google docs
Verified 2026-10-09

Read on 2026-10-09. Google's page showed "Last updated 2026-09-24 UTC". Notes under a quote are close paraphrases of the same page. This page covers only what Google documents.

How to apply it

A checklist built only from the guidance in Google's page.

  1. Add VideoObject markup on a page where users can watch the video, with name, thumbnailUrl and uploadDate.
  2. Add contentUrl if you can, otherwise embedUrl, and give timezone information in uploadDate.
  3. Use unique name and description text for each video.
  4. Validate with the Rich Results Test and check the page with the URL Inspection tool.
  5. For key moments, use Clip or SeekToAction, or YouTube description timestamps if the video is hosted there.

Related: Google video SEO best practices, Google's structured data guidelines, Which structured data Google still shows.

Questions

Which VideoObject properties are required?

Google lists name, thumbnailUrl and uploadDate as required.

Should I give contentUrl or embedUrl?

Google recommends contentUrl where possible, and embedUrl as an alternative when contentUrl isn't available.

How do I get a LIVE badge?

Google says to mark the video with BroadcastEvent, follow the LIVE badge guidelines and use the Indexing API.

Can I turn off key moments?

Google says the nosnippet meta tag opts out of the key moments feature completely.

Does the Indexing API work for all videos?

No. Google says it only supports livestream videos.

How current is this page?

Every quote was read from Google's page on 2026-10-09. The page showed "Last updated 2026-09-24 UTC". Google can change its documentation, so treat the linked page as the final word.

Sources

Let Balzac write the articles.

Type your website. Balzac finds the searches you can win, writes articles built to rank on Google and get cited by ChatGPT, and publishes them for you.

3 free articles · No card needed