Video Schema Generator - JSON-LD for Video Rich Results
Import existing JSON-LD
Paste JSON-LD or a full <script> tag. Matching fields fill the form; properties the form doesn't cover are kept in the output as they are.
Video Details
Media
Use the boxes, or type ISO 8601 (PT1H30M) or plain text like "1h 30m".
JSON-LD Output
What is Video schema?
Video schema is structured data that describes a video on your page: its title, thumbnail, upload date, length, and where the file or player lives. It uses the schema.org VideoObject type in a JSON-LD block. Google uses it to find the video, show it with a thumbnail and duration, and decide whether it qualifies for features like key moments.
Google can sometimes work out these details on its own, especially for YouTube embeds, but markup lets you state them directly. For self-hosted video it is often the only reliable way for Google to learn the thumbnail and file location.
Video schema example (JSON-LD)
A complete example you can adapt. Paste it into the page's HTML, or build your own with the generator above.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "VideoObject",
"name": "How to Replace a Bike Chain in 5 Minutes",
"description": "A step-by-step guide to measuring, removing, and fitting a new chain on a road or mountain bike using a chain tool.",
"thumbnailUrl": [
"https://example.com/videos/bike-chain/thumb-16x9.jpg",
"https://example.com/videos/bike-chain/thumb-4x3.jpg",
"https://example.com/videos/bike-chain/thumb-1x1.jpg"
],
"uploadDate": "2026-03-14T08:00:00+00:00",
"duration": "PT5M12S",
"contentUrl": "https://example.com/videos/bike-chain/bike-chain.mp4",
"embedUrl": "https://example.com/videos/bike-chain/embed/",
"hasPart": [
{
"@type": "Clip",
"name": "Measuring chain wear",
"startOffset": 20,
"endOffset": 95,
"url": "https://example.com/videos/bike-chain/?t=20"
},
{
"@type": "Clip",
"name": "Removing the old chain",
"startOffset": 95,
"endOffset": 180,
"url": "https://example.com/videos/bike-chain/?t=95"
}
]
}
</script> Which Google rich result does it enable?
VideoObject markup makes a page eligible for video results: a thumbnail with the duration badge in the main results, the Videos tab, and Discover. Adding Clip objects through hasPart (or a SeekToAction) can enable key moments, which link straight to sections of the video.
For live streams, a BroadcastEvent in the publication property can earn the red LIVE badge. Google also requires that the video is the main content of the page, or at least prominent on it, for the page to be treated as a video page.
Required and recommended properties
| Property | Status | Notes |
|---|---|---|
name | Required | The video's title. |
thumbnailUrl | Required | One or more crawlable image URLs. Google recommends supplying several aspect ratios. |
uploadDate | Required | ISO 8601 date, ideally with time and time zone, like 2026-03-14T08:00:00+00:00. |
description | Recommended | A summary of the video. No longer required by Google, but still worth including. |
duration | Recommended | ISO 8601 duration such as PT5M12S. |
contentUrl | Recommended | The actual media file. Google prefers this over embedUrl for fetching the video. |
embedUrl | Recommended | The URL of the player, not the page the player sits on. |
hasPart (Clip) | Recommended | Named segments with start and end offsets in seconds, for key moments. |
interactionStatistic, expires, regionsAllowed | Recommended | View counts, an expiry date for videos that come down, and where the video can be watched. |
Common Video schema mistakes
- Writing durations as
5:12or5 minutesin hand-written markup. The value must be ISO 8601, such asPT5M12S. The generator converts entries like5m 12sfor you. - Using the watch page URL as
embedUrl. It should be the player URL, such ashttps://www.youtube.com/embed/VIDEO_ID. - Blocking thumbnails or video files in robots.txt, or serving them only to logged-in users. Googlebot has to fetch them.
- Marking up a video that is buried at the bottom of an unrelated article. Google wants the video to be a main part of the page.
- Clip offsets in minutes instead of seconds, or clips that overlap or run past the video's duration.
YouTube embeds vs self-hosted video
For a YouTube embed, Google already knows the video from YouTube, so
the markup mainly tells it that your page is a video page and which
title and thumbnail to use for it. Set embedUrl to
https://www.youtube.com/embed/VIDEO_ID. For a self-hosted
file, the markup matters more: contentUrl and
thumbnailUrl are how Google finds the file and the image to
show, and both must be fetchable by Googlebot.
Writing durations
ISO 8601 durations start with PT, then hours, minutes, and
seconds with a letter after each number: PT1H30M is an
hour and a half, PT45S is 45 seconds. The generator checks
the duration you type and warns if it is not valid ISO 8601. You can
also use the hours and minutes boxes, or type 1h 30m or
0:05:12 (hours, minutes, seconds) and it converts the value for you.
Related Tools
Local Business Schema Generator
Generate LocalBusiness JSON-LD for Google Maps and local search results.
Product Schema Generator
Generate Product JSON-LD with price, availability, and review stars.
Article Schema Generator
Generate Article JSON-LD for rich results with headline and thumbnail.
FAQ Schema Generator
Generate FAQPage JSON-LD. Rich results limited to government and health sites since August 2023.