Video Schema Generator

Create VideoObject JSON-LD with the title, thumbnail, and upload date Google requires, plus duration, the video file, and an optional key moment.

Key moment (optional)

JSON-LD

Rich Results Test ↗

Missing required fields

  • Add the video title. Google requires name, and it should be unique on your site.
  • Add a thumbnail image URL. Google requires thumbnailUrl.
  • Add the upload date. Google requires uploadDate in ISO 8601.

Recommended fields still open

  • Add a description written for this video.
  • Add the duration. Google wants an ISO 8601 duration such as PT1H30M5S.
  • Add contentUrl (the video file) or embedUrl (the player). Google recommends contentUrl first.
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "VideoObject"
}
</script>

Paste the script into the page HTML, in the head or before </body>. Then open Google's Rich Results Test, choose the code tab, and paste it again.

VideoObject on schema.org · Google's documentation

Want the marketing handled too?

SEOchat publishes pages about your business, keeps your Google listing active, and reports results every week. Starter is $99/month. Growth is $179/month. Cancel anytime.

A business name and website you already typed are carried into checkout. They do not change the price.

The three fields Google requires

A video needs a title, a thumbnail, and the date it was first published. The title should be unique on the site. The thumbnail should be a unique image of this video, not a generic logo. The date should include a time and, when you know it, a timezone. Google says that without a timezone it will assume Googlebot's.

Recommended fields are the description, the duration as an ISO 8601 length such as PT1H30M5S, and either the file URL or the player URL. A creator needs a name if you include one, and a URL is recommended. A watch count becomes an InteractionCounter for WatchAction, which is the type Google documents for views.

How to add this markup

  1. Put the markup on the page where the video can be watched, and where the title and thumbnail match.
  2. Fill the title, thumbnail, and upload date first. Those are the required warnings.
  3. Add hours, minutes, and seconds. The tool writes the ISO duration.
  4. Add a key moment only if you want that label. It needs a name, a start in seconds, and a URL with the time.
  5. Copy the script and test it in Google's Rich Results Test.

A written story around the video can also use the article schema generator. Questions under the video can use the FAQ schema generator if they are visible. The channel or the company can use the organization schema generator.

Questions

What does Google require for a video?

name, thumbnailUrl, and uploadDate. The thumbnail has to be a real image URL for that video. The upload date is ISO 8601. A timezone is recommended. Without the three required fields, Google says it may not be able to extract the video.

Is the description required?

Google's current video documentation lists description as recommended, not required. Write one anyway. It should describe this video, not every video on the site.

What is the difference between contentUrl and embedUrl?

contentUrl is the video file, such as an mp4. embedUrl is the player. Google says the file is the better one for fetching the video. Neither should be the article page the player sits on.

How do key moments work?

A Clip needs a name, a startOffset in seconds, and a URL that opens the same video at that time. Google also has SeekToAction for sites that want Google to build moments from a URL pattern. This tool writes Clip, which is the one you control yourself.

How long does a video have to be?

The video rich result is not limited to 30 seconds in the required-field list. Key moments have a separate 30-second minimum in Google's video documentation. Enter the real duration either way.

More free tools

See all tools