Video Schema Generator

1. 1.

   Enter video details

   Paste a YouTube link to autofill the thumbnail and embed URL, then add a title, description and upload date.

2. 2.

   Check required fields

   Google requires name, thumbnailUrl and uploadDate. Add a contentUrl or embedUrl too.

3. 3.

   Copy and validate

   Paste the script into the page’s <head> and test it with Google’s Rich Results Test.

The Rich Results Test reports a missing field

Google requires name, thumbnailUrl and uploadDate. Fill in all three.

The upload date is flagged, or the date looks off by a day

Use ISO 8601 and add a time zone, for example 2026-03-31T08:00:00+08:00. Without one, Google uses Googlebot’s time zone.

The duration is invalid

Duration must be in ISO 8601: PT1M54S is one minute 54 seconds. Type mm:ss in the generator and it converts it.

The thumbnail isn’t picked up

Use a BMP, GIF, JPEG, PNG, WebP, SVG or AVIF image of at least 60 × 30 px (larger is better) that Googlebot can fetch — not blocked by robots.txt or a login.

The markup is valid but no video result appears

Put the markup on the page where the video plays, and make sure the video isn’t hidden behind other elements. Valid markup makes a page eligible; Google decides what to show.

Google can’t fetch the video

Add contentUrl (the video file itself) or, if you don’t have one, embedUrl (the player). Neither should point to the page the video is on.

Key moments don’t show

Add Clip or SeekToAction markup, or chapters in the YouTube description for YouTube videos. A nosnippet meta tag turns key moments off.

Google needs three properties before a video can appear with video features in search:

• name — the video title. Each video on your site should have its own.

• thumbnailUrl — the thumbnail image. It must be at least 60 × 30 px and reachable by Googlebot.

• uploadDate — when the video was first published.

uploadDate tells Google when the video first went live. Write it in ISO 8601 and include the time zone, like 2026-03-31T08:00:00+08:00; without a time zone, Google assumes Googlebot’s. Use the original publish date, and don’t change it each time you edit the page.

Recommended properties make the markup more useful:

• contentUrl or embedUrl — where Google can get the video. Google prefers contentUrl, the file itself; use embedUrl, the player address, when there’s no file. Neither should be the address of the page.

• description and duration (ISO 8601, e.g. PT3M30S).

• expires for videos that will be taken down, and regionsAllowed or ineligibleRegion for videos limited to some countries.

Put the markup on the page where the video can actually be watched, then check it with Google’s Rich Results Test. Full list: Google’s video structured data documentation.

Key moments are the labelled segments Google can show under a video in search, so people jump straight to the part they need. There are three ways to get them:

• Clip markup — you list the segments yourself in hasPart. Each Clip has a name, a startOffset in seconds, an optional endOffset, and a url that opens the video at that point (the same page URL plus a time parameter, like ?t=120). Google uses these labels before its own guesses.

• SeekToAction markup — you tell Google how your page links to a moment, with {seek_to_second_number} where the time goes. Google then finds the moments itself. It must be able to fetch the video file, and it works in a limited set of languages.

• YouTube chapters — for videos hosted on YouTube, timestamps in the video description can work instead of markup.

YouTube’s rules for chapters in the description:

• The first timestamp is 00:00.

• At least three timestamps, in ascending order, each on its own line with a label.

• Each chapter is at least 10 seconds long.

A nosnippet meta tag turns key moments off. Details: Google: video structured data, YouTube Help: video chapters.