Videos

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 content carousels and videos in Top Stories for AMP.

Examples

Example 1: Video markup for AMP, JSON-LD

Example 2: Standard video markup, JSON-LD

Example 3: Standard video markup, Microdata

Type definitions

Properties
name

Text, required

The title of the video

Description

Text, required

The description of the video

thumbnailUrl

URL, required

A URL pointing to the video thumbnail image file. Images must be at least 160x90 pixels and at most 1920x1080 pixels. We recommend images in .jpg, .png, or .gif formats. All image URLs should be crawlable and indexable. Otherwise, we will not be able to display them on the search results page.

uploadDate

Date, required

The date the video was first published, in ISO 8601 format.

duration

Duration, recommended

The duration of the video in ISO 8601 format.

contentUrl

URL, recommended

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 and video previews and can help Google verify your video. Tip: You can confirm that it's really Googlebot accessing 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. Example: Dailymotion. Tip: you can ensure that only Googlebot accesses your content by using a reverse DNS lookup.

interactionCount

Text, recommended

The number of times the video has been viewed.

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.

Send feedback about...