Webmasters

Video Search - Webmaster EDU

Schema.org for Videos

Google recommends using the schema.org on-page markup for videos. The schema.org vocabulary was developed and is supported by Google, Bing, and Yahoo! Using schema.org to describe your videos will allow Google to index and show your videos in search.

  • Use the schema.org/VideoObject type to describe videos. (Find the full specification at schema.org.)
  • Make sure that your video and schema.org markup are visible without executing any JavaScript or Flash. To see how your site will appear to Google, you should view your play pages in a text-only browser such as Lynx, or a more conventional browser where you've confirmed that Flash and JavaScript are disabled.
  • You can and should also submit a video Sitemap that helps Google discover your videos and provides additional information about your video content.

Adding VideoObject to a video page

Add schema.org markup directly to the HTML of your video page. The markup will not be visible to users and will not affect how your page looks. When Google crawls your page, we'll use this information to index your video. While only a few properties are required, providing additional information helps Google understand your video and enhance its appearance in search results.

Here's an example of marked-up HTML content for a video:

<div itemprop="video" itemscope itemtype="http://schema.org/VideoObject">
  <h2>Video: <span itemprop="name">Title</span></h2>
  <meta itemprop="duration" content="T1M33S" />
  <meta itemprop="thumbnailUrl" content="thumbnail.jpg" />
  <meta itemprop="contentURL" content="http://www.example.com/video123.flv" />
  <meta itemprop="embedURL" content="http://www.example.com/videoplayer.swf?video=123" />
  <meta itemprop="uploadDate" content="2011-07-05T08:00:00+08:00" />
  <meta itemprop="expires" content="2012-01-30T19:00:00+08:00" />
  <meta itemprop="height" content="400" />
  <meta itemprop="width" content="400" />
  <object ...>
    <param ...>
    <embed type="application/x-shockwave-flash" ...>
  </object>
  <span itemprop="description">Video description</span>
</div>

schema.org VideoObject properties

Google recommends marking up your video content with the following tags. See the full list of VideoObject properties at schema.org.

Property Required? Description
name Required The title of the video
description Required The description of the video
thumbnailURL Required A URL pointing to the video thumbnail image file. Images must be at least 160 x 90 pixels and at most 1920x1080 pixels. We recommend images in .jpg, .png, or. gif formats.
contentURL Depends

At least one of contentURL or embedURL is required.

A URL pointing to the actual video media file. 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 automatically.

Best practice: Ensure that only Googlebot accesses your content by using a reverse DNS lookup.

embedURL Depends

At least one of contentURL or embedURL is required.

A URL pointing to a player for the specific video. Usually this is the information in the src element of an <embed> tag. Example:

Dailymotion: http://www.dailymotion.com/swf/x1o2g

Best practice: Ensure that only Googlebot accesses your content by using a reverse DNS lookup.

duration Recommended The duration of the video in ISO 8601 format.
uploadDate Recommended The date the video was first published, in ISO 8601 format.
expires Optional 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.
height Optional The height of the video in pixels, including the chrome of the video player.
width Optional The width of the video in pixels, including the chrome of the video player.

Once you have added markup to your page, use the Rich Snippet Testing Tool to make sure that Google can correctly read your markup. If your markup shows up correctly in the tool, Google will read and process it the next time we crawls your page.

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.