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. 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.

Examples

Example 1: Video markup for AMP, JSON-LD <script type="application/ld+json"> { "@context": "http://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" } </script>

Example 2: Standard video markup, JSON-LD { "@context": "http://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" }

Type definitions

Properties
description	Text, required The description of the video.
duration	Duration, recommended The duration of the video in ISO 8601 format.
expires	Text, recommended 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.
interactionCount	Text, recommended The number of times the video has been viewed.
name	Text, required The title of the video
thumbnailUrl	Repeated field of ImageObject or URL, required 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, required The date the video was first published, in ISO 8601 format.
URL to your content	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. contentUrl URL, recommended A URL pointing to the actual video media file. For example: "contentUrl": "https://www.example.com/video/123/file.mp4" This file should be in .mpg, .mpeg, .mp4, .m4v, .mov, .wmv, .asf, .avi, .ra, .ram, .rm, .flv, or other video file format. All files must be accessible via HTTP. Metafiles that require a download of the source via streaming protocols, such as RTMP, are not supported. Providing this file allows Google to generate video thumbnails and video previews and can help Google verify your video. Tip: You can ensure that only Googlebot accesses your content by using a reverse DNS lookup. embedUrl URL, recommended A URL pointing to a player for the specific video. Usually this is the information in the src element of an <embed> tag. For example: "embedUrl": "https://www.example.com/embed/123" Tip: You can ensure that only Googlebot accesses your content by using a reverse DNS lookup.