Skip to content

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

hmin

Use the boxes, or type ISO 8601 (PT1H30M) or plain text like "1h 30m".

Google Search Preview
Video Title
example.com
All Google requirements met

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:12 or 5 minutes in hand-written markup. The value must be ISO 8601, such as PT5M12S. The generator converts entries like 5m 12s for you.
  • Using the watch page URL as embedUrl. It should be the player URL, such as https://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

Frequently Asked Questions

Which fields does Google require for video rich results?
Three: name, thumbnailUrl and uploadDate. description, duration, contentUrl, embedUrl and Clip markup for key moments are recommended.
Why isn't my video showing as a video result?
The most common reason is that Google doesn't treat the page as a video page. The video has to be the main content, or at least prominent near the top, not tucked under a long article. Also check that the thumbnail and video file aren't blocked in robots.txt.
What format should I use for video duration?
ISO 8601. PT5M30S is 5 minutes 30 seconds, PT1H2M is 1 hour 2 minutes, PT30S is 30 seconds. The generator accepts 5m 30s and converts it. Don't type 5:30, which it reads as hours and minutes.
What is the difference between contentUrl and embedUrl?
contentUrl is the media file itself, such as an .mp4. embedUrl is the player, such as https://www.youtube.com/embed/VIDEO_ID. Give at least one; Google prefers contentUrl when it has a choice.
How do I get key moments for my video?
Add Clip objects in hasPart, each with a name, startOffset and endOffset in seconds and a url that jumps to that point. The generator doesn't build clips, so add them to the output by hand, as in the example. For YouTube videos, timestamps in the YouTube description can do the same job.