
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
Here's an example of video structured data for AMP using JSON-LD.
Here's an example of standard video markup using JSON-LD.
Structured data type definitions
The full definition of VideoObject
is available at
schema.org/VideoObject. You must include the
required properties for your content to be eligible for display as a rich result.
You can also include the recommended properties to add more information about your content,
which could provide a better user experience.
Required properties | |
---|---|
description |
The description of the video. |
name |
The title of the video |
thumbnailUrl |
Repeated field of ImageObject or URL A URL pointing to the video thumbnail image file. Additional image guidelines:
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 |
The date the video was first published, in ISO 8601 format. |
Recommended properties | |
---|---|
contentUrl
|
A URL pointing to the actual video media file. Make sure to follow our Video best practices. |
duration |
The duration of the video in ISO 8601 format. |
embedUrl
|
A URL pointing to a player for the specific video. Usually this is the information in
the Make sure to follow our Video best practices. |
expires |
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 |
The number of times the video has been viewed. |