Video Structured Data For SEO

Google search is an entry point for people to discover your videos. Providing additional details about the videos to google explicitly can lead to better SEO. One can share all these additional video data with google with VideoObject

VideoObject

The full definition of VideoObject is available here. You can include the following required properties along with some recommended properties.

Required Properties

Key	Details	Type
description	The description of the video. HTML tags are ignored.	Text
name	Title of the video	Text
thumbnailUrl	A URL pointing to the video thumbnail image file.	URL
uploadDate	The date when video was first published, in ISO 8601 format.	Date

Recommended Properties

Key	Details	Type
contentUrl	A URL pointing to the actual video media file. Here are all supporting formats.	URL
duration	The duration of the video in ISO 8601 format. For example, PT00H20M8S represents a duration of "twenty minutes and eight seconds".	Duration
embedUrl	A URL pointing to a player for the specific video. Don't link to the page where the video lives; this must be the URL of the video player itself. Usually, this is the information in the src element of an tag. This is an alternative if you are not passing contentUrl	URL
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.	Date
regionsAllowed	The regions where the video is allowed. If not specified, then Google assumes the video is allowed everywhere. Specify the countries in ISO 3166 format.	Place
publication	If your video is happening live and you want to be eligible for the LIVE badge.	Object

Example

{
      "@context": "https://schema.org",
      "@type": "VideoObject",
      "name": "Sample Gumlet Video",
      "description": "This is a sample video description for sample video.",
      "thumbnailUrl": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg"
       ],
      "uploadDate": "2022-01-15T08:00:00+08:00",
      "duration": "PT1M54S",
      "contentUrl": "https://www.example.com/video/123/file.mp4",
      "embedUrl": "https://www.example.com/embed/123",
      "regionsAllowed": "IN,US"
    }

For live videos, we can add an additional property like below.

"publication": [
        {
          "@type": "BroadcastEvent",
          "isLiveBroadcast": true,
          "startDate": "2022-10-27T14:00:00+00:00",
          "endDate": "2022-10-27T15:00:00+00:00"
        }
     ]