Video

Does your site stream live videos? Add livestream structured data.

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. Google may use your markup to power carousels (for example, the Top stories carousel with AMP). Video markup enables a badge on the image in mobile image search results, which can encourage more users to click your content.

Mark up video gallery pages (a page with a list of videos) using ItemList structured data. Galleries of videos may be displayed as a host carousel. For more information about host-specific lists, see Carousel.

Video markup is not required, but is the recommended way of helping Google crawl and index your videos.

Examples

Here's an example of video structured data for AMP using JSON-LD.

{ "@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", "interactionCount": "5647018" }

Here's an example of standard video markup using JSON-LD.

{ "@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", "interactionCount": "5647018" }

Here's an example of a video with clips using JSON-LD. Learn more about how to use clips with How-to structured data.

{ "@context": "https://schema.org", "@type": "VideoObject", "name": "Build a Trivia Game for the Google Assistant with No Code", "description": "Learn how to create a Trivia action for Assistant within minutes.", "thumbnailUrl": "https://example.com/photos/photo.jpg", "contentUrl": "https://www.youtube.com/watch?v=4AOI1tZrgMI", "embedUrl": "https://www.youtube.com/embed/4AOI1tZrgMI", "uploadDate": "2019-01-05T08:00:00+08:00", "duration": "P1MT10S", "hasPart": [ { "@type": "Clip", "@id": "Clip1", "name": "Open Actions on Google Console", "startOffset": 29, "endOffset": 36, "url": "http://www.example.com/example&t=29" }, { "@type": "Clip", "@id": "Clip2", "name": "Select Trivia Template", "startOffset": 36, "endOffset": 45, "url": "http://www.example.com/example&t=36" }, { "@type": "Clip", "@id": "Clip3", "name": "Choose a Personality", "startOffset": 45, "endOffset": 65, "url": "http://www.example.com/example&t=45" } ] } }

Here's an example of a video gallery page with JSON-LD ItemList markup.

{ "@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", "interactionCount": "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", "interactionCount": "102111" } ] }

Here's an example of a video gallery page with microdata ItemList markup.

<div> <div itemprop="video" itemscope itemtype="http://schema.org/VideoObject"> <!-- Thumbnail --> <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> <!-- URL, name, and description --> <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> <!-- Other metadata --> <meta itemprop="duration" content="PT1M54S" /> <meta itemprop="uploadDate" content="2016-03-31T08:00:00+08:00" /> <meta itemprop="interactionCount" content="5647018" /> </div> <div itemprop="video" itemscope itemtype="http://schema.org/VideoObject"> <!-- Thumbnail --> <a href="https://example.com/videos/how-to-tie-a-tie" title="How to tie a tie"> <img src="https://example.com/videos/how-to-tie-a-tie/thumbnail.jpg" alt="How to tie a tie" title="How to tie a tie" itemprop="thumbnailUrl"> </a> <!-- URL, name, and description --> <h1> <a itemprop="url" href="https://example.com/videos/how-to-tie-a-tie" title="Tie a Tie"> <span itemprop="name">Tie a Tie</span> </a> </h1> <a href="https://example.com/videos/how-to-tie-a-tie" title="Tie a Tie"> <div itemprop="description">How to tie a four-in-hand knot.</div> </a> <!-- Other metadata --> <meta itemprop="duration" content="PT5M01S" /> <meta itemprop="uploadDate" content="2019-01-05T08:00:00+08:00" /> <meta itemprop="interactionCount" content="102111" /> </div> </div>

Structured data type definitions

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.
name	Text The title of the video
thumbnailUrl	Repeated ImageObject or URL A URL pointing to the video thumbnail image file. Additional image guidelines: Every page must contain at least one image (whether or not you include markup). Google will pick the best image to display in Search results based on the aspect ratio and resolution. Image URLs must be crawlable and indexable. Images must represent the marked up content. Images must be in .jpg, .png, or. gif format. For best results, provide multiple high-resolution images (minimum of 50K pixels when multiplying width and height) with the following aspect ratios: 16x9, 4x3, and 1x1. For example: "image": [ "https://example.com/photos/1x1/photo.jpg", "https://example.com/photos/4x3/photo.jpg", "https://example.com/photos/16x9/photo.jpg" ]
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.
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	Text 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.
hasPart	CreativeWork A video clip that is part of the entire video. To add clips to steps in a how-to page, see How-to structured data.
hasPart.endOffset	Number The end time of the clip expressed as the number of seconds from the beginning of the video.
hasPart.name	Text The name of the clip. For example, "Pull and tighten" could be the name of the clip that shows how to pull and tighten a tie.
hasPart.startOffset	Number The start time of the clip expressed as the number of seconds from the beginning of the video.
hasPart.url	URL A link to the start time of the clip. The start time must match the value set in hasPart.startOffset. For example: "startOffset": 30, "endOffset": 45, "url": "http://www.example.com/example&t=30"
interactionCount	Text The number of times the video has been viewed.

ItemList

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

In addition to VideoObject properties, add the following properties for host-specific lists. While ItemList isn't required, it can help Google identify content that is appropriate for host carousels. For more information about host-specific lists, see Carousel.

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.