Video

Mark up your video content with structured data to make Google Search an entry point for discovering and watching videos. You can provide details such as the description, thumbnail URL, upload date, and duration by marking up your video with VideoObject. You can also add additional structured data to your VideoObject to enable the following video enhancements:

Video Carousel: Mark up video gallery pages (a page with a list of videos) using ItemList structured data.
Video Segments: Mark important segments in your video with Clip structured data, which enables users to quickly navigate to specific points in a video.
Video Segments is currently limited to a small set of providers. If you would like to participate, register your interest in our form.

By structuring your content according to this guide, your content may automatically enable a video badge in mobile image Search results.

Examples

Standard video rich result

Here's an example of standard video markup using JSON-LD. It only has the VideoObject and isn't eligible for a Video Carousel or Video Segments.

<html>
<head>
<title>Introducing the self-driving bicycle in the Netherlands</title>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "Introducing the self-driving bicycle in the Netherlands",
  "description": "This spring, Google is introducing the self-driving bicycle in Amsterdam, the world’s premier cycling city. The Dutch cycle more than any other nation in the world, almost 900 kilometres per year per person, amounting to over 15 billion kilometres annually. The self-driving bicycle enables safe navigation through the city for Amsterdam residents, and furthers Google’s ambition to improve urban mobility with technology. Google Netherlands takes enormous pride in the fact that a Dutch team worked on this innovation that will have great impact in their home country.",
  "thumbnailUrl": [
    "https://example.com/photos/1x1/photo.jpg",
    "https://example.com/photos/4x3/photo.jpg",
    "https://example.com/photos/16x9/photo.jpg"
   ],
  "uploadDate": "2016-03-31T08:00:00+08:00",
  "duration": "PT1M54S",
  "contentUrl": "https://www.example.com/video/123/file.mp4",
  "embedUrl": "https://www.example.com/embed/123",
  "interactionStatistic": {
    "@type": "InteractionCounter",
    "interactionType": { "@type": "http://schema.org/WatchAction" },
    "userInteractionCount": 5647018
  }
}
</script>
</head>
<body>
</body>
</html>

Video Carousel

Here's an example of a page with a list of videos. To enable the Video Carousel, the page has VideoObject and additional ItemList structured data.

JSON-LD

<html>
<head>
<title>Introducing the self-driving bicyle in the Netherlands</title>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ItemList",
  "itemListElement": [
    {
      "@type": "VideoObject",
      "position": 1,
      "name": "Introducing the self-driving bicycle in the Netherlands",
      "url": "https://www.example.com/video/self-driving-bicycle",
      "description": "This spring, Google is introducing the self-driving bicycle in Amsterdam, the world’s premier cycling city. The Dutch cycle more than any other nation in the world, almost 900 kilometres per year per person, amounting to over 15 billion kilometres annually. The self-driving bicycle enables safe navigation through the city for Amsterdam residents, and furthers Google’s ambition to improve urban mobility with technology. Google Netherlands takes enormous pride in the fact that a Dutch team worked on this innovation that will have great impact in their home country.",
      "thumbnailUrl": [
        "https://www.example.com/video/self-driving-bicycle/1x1/photo.jpg",
        "https://www.example.com/video/self-driving-bicycle/4x3/photo.jpg",
        "https://www.example.com/video/self-driving-bicycle/16x9/photo.jpg"
      ],
      "uploadDate": "2016-03-31T08:00:00+08:00",
      "duration": "PT1M54S",
      "contentUrl": "https://www.example.com/video/self-driving-bicycle/file.mp4",
      "embedUrl": "https://www.example.com/embed/self-driving-bicycle",
      "interactionStatistic": {
        "@type": "InteractionCounter",
        "interactionType": { "@type": "http://schema.org/WatchAction" },
        "userInteractionCount": 5647018
      }
    },
    {
      "@type": "VideoObject",
      "position": 2,
      "name": "How to tie a tie",
      "url": "https://www.example.com/video/how-to-tie-a-tie",
      "description": "How to tie a four-in-hand knot.",
      "thumbnailUrl": [
        "https://www.example.com/video/how-to-tie-a-tie/1x1/photo.jpg",
        "https://www.example.com/video/how-to-tie-a-tie/4x3/photo.jpg",
        "https://www.example.com/video/how-to-tie-a-tie/16x9/photo.jpg"
      ],
      "uploadDate": "2019-02-28T08:00:00+08:00",
      "duration": "PT5M01S",
      "contentUrl": "https://www.example.com/video/how-to-tie-a-tie/file.mp4",
      "embedUrl": "https://www.example.com/embed/how-to-tie-a-tie",
      "interactionStatistic": {
        "@type": "InteractionCounter",
        "interactionType": { "@type": "http://schema.org/WatchAction" },
        "userInteractionCount": 102111
      }
    }
  ]
}
</script>
</head>
<body>
</body>
</html>

Microdata

<div>
      <div itemprop="video" itemscope itemtype="http://schema.org/VideoObject">
        
        <a href="https://example.com/videos/self-driving-bicycle"
           title="Introducing the self-driving bicycle in the Netherlands">
          <img src="https://example.com/videos/self-driving-bicycle/thumbnail.jpg"
               alt="Introducing the self-driving bicycle in the Netherlands"
               title="Introducing the self-driving bicycle in the Netherlands"
               itemprop="thumbnailUrl">
        </a>
        
        <h1>
          <a itemprop="url" href="https://example.com/videos/self-driving-bicycle"
             title="Introducing the self-driving bicycle in the Netherlands">
            <span itemprop="name">Introducing the self-driving bicycle in the Netherlands</span>
          </a>
        </h1>
        <a href="https://example.com/videos/self-driving-bicycle"
             title="Introducing the self-driving bicycle in the Netherlands">
          <div itemprop="description">"This spring, Google is introducing the self-driving bicycle
            in Amsterdam, the world’s premier cycling city. The Dutch cycle more than any other
            nation in the world, almost 900 kilometres per year per person, amounting to over 15
            billion kilometres annually. The self-driving bicycle enables safe navigation through
            the city for Amsterdam residents, and furthers Google’s ambition to improve urban
            mobility with technology. Google Netherlands takes enormous pride in the fact that a
            Dutch team worked on this innovation that will have great impact in their home country.
          "</div>
        </a>
        
        <meta itemprop="duration" content="PT1M54S" />
        <meta itemprop="uploadDate" content="2016-03-31T08:00:00+08:00" />
        <span itemprop="interactionStatistic" itemscope itemtype="http://schema.org/InteractionCounter">
        	<span itemprop="interactionType" itemscope itemtype="http://schema.org/WatchAction"></span>
        	<meta itemprop="userInteractionCount" content="5647018" />
        </span>
      </div>

Video Segments (limited access)

Here's a JSON-LD example of VideoObject with additional Clip structured data to mark video segments. Video Segments is currently limited to a small set of providers. If you would like to participate, register your interest in our form.

AMP page with a video

Here's an example of a VideoObject on an AMP page.

<html>
<head>
<title>Introducing the self-driving bicycle in the Netherlands</title>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "Introducing the self-driving bicycle in the Netherlands",
  "description": "This spring, Google is introducing the self-driving bicycle in Amsterdam, the world’s premier cycling city. The Dutch cycle more than any other nation in the world, almost 900 kilometres per year per person, amounting to over 15 billion kilometres annually. The self-driving bicycle enables safe navigation through the city for Amsterdam residents, and furthers Google’s ambition to improve urban mobility with technology. Google Netherlands takes enormous pride in the fact that a Dutch team worked on this innovation that will have great impact in their home country.",
  "thumbnailUrl": "https://www.example.com/thumbnail.jpg",
  "uploadDate": "2016-03-31T08:00:00+08:00",
  "duration": "PT1M54S",
  "publisher": {
    "@type": "Organization",
    "name": "Google Nederland",
    "logo": {
      "@type": "ImageObject",
      "url": "https://example.com/logo.jpg",
      "width": 600,
      "height": 60
    }
  },
  "contentUrl": "https://www.example.com/video/123/file.mp4",
  "embedUrl": "https://www.example.com/embed/123",
  "interactionStatistic": {
    "@type": "InteractionCounter",
    "interactionType": { "@type": "http://schema.org/WatchAction" },
    "userInteractionCount": 5647018
  }
}
</script>
</head>
<body>
</body>
</html>

Guidelines

You must follow these guidelines for your video to be eligible to appear as a video rich result

Webmaster guidelines
General structured data guidelines
Video best practices
Carousel guidelines (if applicable)
Video Segment guidelines (if applicable)

Video Segment guidelines (limited access)

If you're adding Clip to mark video segments, follow these guidelines:

The video must be publicly available to watch without a subscription.
The video must have the ability to deep link into some point other than the start point in the video URL. For example, http://www.example.com/example?t=30 starts 30 seconds into a video.
Video segment structured data must be added to a page where users can watch the video. It's a bad user experience to point users to a page where they can't watch the video.
The total video duration must be a minimum of 30 seconds.
Make sure that no two clips on the same video defined on the same page share a start time.
The video must have VideoObject structured data.

Structured data type definitions

This section describes the structured data types related to video features in Google Search. You must include the required VideoObject properties for your content to be eligible for display as a video rich result. You can also include the recommended properties to add more information about your content, which could provide a better user experience. In addition to VideoObject, you can add the following data types to enable video enhancements in Google Search:

ItemList: Mark up pages with a list of videos to enable a Video Carousel.
Clip: Mark important segments in your video to help users quickly navigate to specific points in a video.
Does your video teach users how to complete a task step-by-step? Embed your video content within How-to structured data.

VideoObject

The full definition of VideoObject is available at schema.org/VideoObject. If you do not include the required properties, Google may not be able to extract any information about the video. You can also include the recommended properties to add more information about your content, which could provide a better user experience.

Required properties
`description`	`Text` The description of the video. HTML tags are ignored.
`name`	`Text` The title of the video
`thumbnailUrl`	Repeated `ImageObject` or `URL` A URL pointing to the video thumbnail image file. Image URLs must be crawlable and indexable. Images must represent the marked up content. Images must be in .jpg, .png, or. gif format. Images must 60px x 30px, at minimum.
`uploadDate`	`Date` The date the video was first published, in ISO 8601 format.

Recommended properties
`contentUrl`	`URL` We recommend that you provide a URL to your video. You can provide a URL by using one or both of the following properties: `contentUrl` and `embedUrl`. A URL pointing to the actual video media file. Example "contentUrl": "https://www.example.com/video/123/file.mp4" Make sure to follow our Video best practices. Tip: You can ensure that only Googlebot accesses your content by using a reverse DNS lookup.
`duration`	`Duration` The duration of the video in ISO 8601 format. For example, `T00H30M5S` represents a duration of "thirty minutes and five seconds".
`embedUrl`	`URL` We recommend that you provide a URL to your video. You can provide a URL by using one or both of the following properties: `contentUrl` and `embedUrl`. A URL pointing to a player for the specific video. Usually this is the information in the `src` element of an `<embed>` tag. Example "embedUrl": "https://www.example.com/embed/123" Make sure to follow our Video best practices. Tip: You can ensure that only Googlebot accesses your content by using a reverse DNS lookup.
`expires`	`Date` If applicable, the date after which the video will no longer be available, in ISO 8601 format. Don't supply this information if your video does not expire.
`interactionStatistic`	`InteractionCounter` The number of times the video has been watched. For example: "interactionStatistic": { "@type": "InteractionCounter", "interactionType": { "@type": "http://schema.org/WatchAction" }, "userInteractionCount": 12345 } Starting October 2019, we changed our documentation to recommend `interactionStatistic` instead of `interactionCount`. While we continue to support `interactionCount`, we recommend `interactionStatistic` moving forward.

ItemList

To enable your video to display in a Video Carousel, add the following ItemList properties in addition to VideoObject properties. While ItemList properties aren't required, you must add the following properties if you want your video to display in a Video Carousel. For more information about carousels, see Carousel.

The full definition of ItemList is available at schema.org/ItemList.

Required properties

Required properties
`itemListElement`	`ListItem` Annotation for a single item page. Each `ListItem` element should include VideoObject properties as well as `ListItem` properties.
`ListItem.position`	`Integer` Ordinal position of the item page in the list. For example: "itemListElement": [ { "@type": "VideoObject", "position": 1, ... other VideoObject properties ... }, { "@type": "VideoObject", "position": 2, ... other VideoObject properties ... } ]
`ListItem.url`	`URL` The canonical URL of the item page. Every item should have a unique URL.

itemListElement

ListItem

Annotation for a single item page. Each ListItem element should include VideoObject properties as well as ListItem properties.

ListItem.position

Integer

Ordinal position of the item page in the list. For example:

"itemListElement": [
  {
    "@type": "VideoObject",
    "position": 1,
    ... other VideoObject properties ...
  }, {
    "@type": "VideoObject",
    "position": 2,
    ... other VideoObject properties ...
  }
]

ListItem.url

URL

The canonical URL of the item page. Every item should have a unique URL.

Clip (limited access)

To enable Video Segments for your video, nest the following properties in your VideoObject. While Clip properties aren't required, you must add the following properties if you want your video to display with video segments.

The full definition of Clip is available at schema.org/Clip.

Required properties

Required properties
`name`	`Text` A descriptive title for the content of the clip.
`startOffset`	`Number` The start time of the clip expressed as the number of seconds from the beginning of the work.
`url`	`URL` A URL that points to the start time of the clip. The clip URL must point to the same URL path as the video with additional query parameters that specify the time. For example, the following URL means the video starts at 2:00 minutes: "url": "https://www.example.com/example?t=120"

name

Text

A descriptive title for the content of the clip.

startOffset

Number

The start time of the clip expressed as the number of seconds from the beginning of the work.

url

URL

A URL that points to the start time of the clip.

The clip URL must point to the same URL path as the video with additional query parameters that specify the time.

For example, the following URL means the video starts at 2:00 minutes:

"url": "https://www.example.com/example?t=120"

Recommended properties

Recommended properties
`endOffset`	`Number` The end time of the clip expressed as the number of seconds from the beginning of the work.

endOffset

Number

The end time of the clip expressed as the number of seconds from the beginning of the work.