Last updated:
Video Schema Generator
This video schema generator builds VideoObject JSON-LD from a form: the title, thumbnail and upload date Google requires, the file or player URL, and optional key moments and livestream details. Fill it in for one video and paste the script tag into the page where people watch it.
Reference: Video schema
Video: Use on a page whose main content is a video, so Google can show it in video results with a thumbnail, its length, key moments or a LIVE badge.
What Google shows for Video markup
- Video: shown in Google Search; Google's last documented change was on September 24, 2026.
- Learning video: retired: Google stopped showing it on September 9, 2025.
With valid markup, a video can appear in Google's main results, Video mode, Google Images and Discover. Two extras build on the same block: key moments, which link to points inside the video, and the LIVE badge for a stream. Google still decides what to show, and the markup belongs on a page where the video can be played, not on a list that links to watch pages.
Google requires the name, the thumbnail URL and the upload date. Most other fields are ones Google recommends, such as the description, duration, file or embed URL and creator.
How to fill in each field
Title, thumbnail and upload date
Give each video its own title, the one above the player, and a description of this video rather than the channel. The thumbnail URL should open this video's own thumbnail image. Pick the upload date and time, then put your UTC offset in Time Zone, such as -05:00 or Z; without one, Google falls back on Googlebot's time zone.
Playback and creator
Write the duration in ISO 8601: PT4M30S is four and a half minutes, PT1H2M an hour and two. Video File URL is the MP4 or stream file Google can fetch; Embed URL is the address of the player for this one video. Give both when you have them. Leave Allowed Countries empty unless the video is blocked somewhere, and Expiry Date empty for a video that stays up. Creator is whoever made the video, with a page about them.
Key moments
To choose the moments yourself, add a row per segment: a name, a start in seconds, an optional end, and the video page's URL with the time in its query, such as ?t=95. To let Google find them, leave the rows empty and fill in Automatic Key Moments URL with {seek_to_second_number} where the seconds go; the generator writes the SeekToAction input string Google asks for. Google also says the video must last at least 30 seconds.
Livestream
Tick Livestream for a video that is, was or will be streamed live, and set Stream Start. Google also recommends its Indexing API for livestreams, called when the stream starts and when it stops, so the page is crawled at the right time.
The form marks 3 fields as required and 8 as recommended:
- Video Title (required): The title of the video.
- Thumbnail URL (required): The video's own thumbnail image.
- Upload Date & Time (required): When the video was first published.
- Description (recommended): What the video shows, written for this video alone.
- Time Zone (UTC offset) (recommended): Added to every date and time in this form. Google recommends a time zone for the upload date: an offset such as -05:00, or Z for UTC.
- Duration (recommended): The length in ISO 8601 format: PT4M30S is 4 minutes 30 seconds, PT1H5M is 1 hour 5 minutes.
- Video File URL (recommended): The URL of the video file itself, not of the page it's on.
- Embed URL (recommended): The URL of the player for this video. Give it when there's no file URL.
- Creator Type (recommended): Whether a person or an organization made the video.
- Creator Name (recommended): The person or organization that made the video.
- Creator URL (recommended): A page about the creator.
Example: A recorded livestream with automatic key moments
A webinar streamed live and now on its own page: an upload time with an offset, file and player URLs, an organization as creator, a SeekToAction instead of clips, and the stream's start and end.
{
"@context": "https://schema.org",
"@type": "VideoObject",
"name": "Live Q&A: Why Your WordPress Site Is Slow",
"description": "Two developers answer viewers' questions about caching, image sizes and slow plugins, with a live speed test of a viewer's site.",
"thumbnailUrl": "https://webclinic.example/videos/slow-wordpress-qa-thumb.jpg",
"uploadDate": "2026-10-08T17:00-04:00",
"duration": "PT52M10S",
"contentUrl": "https://webclinic.example/media/slow-wordpress-qa.mp4",
"embedUrl": "https://webclinic.example/embed/slow-wordpress-qa",
"interactionStatistic": {
"@type": "InteractionCounter",
"interactionType": {
"@type": "WatchAction"
},
"userInteractionCount": 3120
},
"creator": {
"@type": "Organization",
"name": "Web Clinic",
"url": "https://webclinic.example/about"
},
"potentialAction": {
"@type": "SeekToAction",
"target": "https://webclinic.example/videos/slow-wordpress-qa?t={seek_to_second_number}",
"startOffset-input": "required name=seek_to_second_number"
},
"publication": {
"@type": "BroadcastEvent",
"isLiveBroadcast": true,
"startDate": "2026-10-08T17:00-04:00",
"endDate": "2026-10-08T17:53-04:00"
}
} 5 common mistakes
- The watch page as the file URL. Video File URL is for the video file itself, such as an MP4, never the page the player sits on.
- Two clips starting at the same second. Google asks that no two clips of a video share a start time. Give each row its own start, in seconds from the beginning.
- Clip links to another page. Google wants each clip URL on the same path as the video, with the time added as a query parameter.
- Minutes and seconds in Duration. "4:30" or "4 min 30 s" isn't a duration Google reads. Write
PT4M30S. - A finished stream with no end time. Google requires the end time once a stream is no longer live. Add Stream End as soon as the broadcast stops.
How to test your Video markup
The validation panel above the output lists what Google needs that's still empty. Press Test in Google Rich Results to copy the code and open Google's test, then paste it into the Code tab. After publishing, test the live URL too, and watch Search Console for video problems once Google has crawled the page.
- Open the example in the Schema Validator, which checks it against schema.org and Google's requirements.
- Preview the example in the SERP Simulator to see which search enhancements it can earn.
- Read the video schema reference for the type's other properties and more examples.
Frequently Asked Questions
Do I need to add key moments to a YouTube video?
Not on YouTube itself: Google may turn on key moments for a YouTube video from its description on YouTube. The Key Moments fields are for the video on your own page, where Google reads the clips or the SeekToAction from your markup.
Should I list clips or use the automatic key moments URL?
List clips to name the moments yourself; Google supports them in every language Search is available in. The automatic URL lets Google find them, but works only in a listed set of languages. The generator writes whatever you fill in, so use one or the other.
What should I enter as the time zone?
The UTC offset where and when you publish: -05:00 for New York in winter, -04:00 in summer, Z for UTC. The generator adds it to the upload date and to the stream's start and end.
Other schema generators
- Local Business Schema Generator
- FAQ Schema Generator
- Product Schema Generator
- Organization Schema Generator
- Article Schema Generator
- Review Schema Generator
- Person Schema Generator
- Event Schema Generator
- Recipe Schema Generator
- Job Posting Schema Generator
- Course Schema Generator
- Software Application Schema Generator
- HowTo Schema Generator
- Breadcrumb Schema Generator
- Profile Page Schema Generator
- QAPage Schema Generator
- Discussion Forum Schema Generator
- Course List Schema Generator
- JSON-LD Generator, with every form and the templates