VideoObject schema markup
Describes a video so it can appear in search with a thumbnail, and support key moments.
Does Google still show a rich result for this?
Supported, including video segments and a LIVE badge for streams. Google requires the markup to sit on a page where the video can actually be watched.
When to use it
On any page hosting or embedding a video that is central to the page.
Required properties
namethumbnailUrluploadDate
Recommended properties
contentUrlembedUrldescriptiondurationexpiresinteractionStatisticregionsAllowed or ineligibleRegion
Example
{
"@context": "https://schema.org",
"@type": "VideoObject",
"name": "How to connect Search Console",
"description": "A three-minute walkthrough.",
"thumbnailUrl": ["https://example.co.uk/thumb.jpg"],
"uploadDate": "2026-07-28T09:00:00+01:00",
"duration": "PT3M12S",
"contentUrl": "https://example.co.uk/video.mp4"
}Common mistakes
- Supplying both regionsAllowed and ineligibleRegion. Use one or the other.
- Reusing the same name and description across videos. Each must be unique.
- Omitting the timezone from uploadDate, in which case Googlebot assumes its own.
- Adding Clip key moments to a video under 30 seconds, or repeating a start time on the same page.
Check what your own pages are missing
Our free checker reads the markup already on a page and names the types it is missing for its page type. No account needed.
Run the schema checker →Verified against Google’s structured data documentation and its changelog on 28/07/2026. Google changes what it supports without much notice — if you are reading this long afterwards, check the current documentation before acting on it. Background on why this markup matters beyond rich results is in the answer engine optimisation guide.