Entity Tracking
- VideoObject Schema: A structured data type defined by Schema.org that provides search engines with metadata about a video file on a webpage.
- JSON-LD: A script-based data format preferred by Google for implementing structured data markup.
- Microdata: An HTML-based format for embedding structured data directly into a page’s source code.
- BroadcastEvent: A nested schema type used to provide information about the start and end times of a live-streamed video.
- Clip: A schema type used to define specific segments of a video, including start and end offsets.
- SeekToAction: A schema property that informs Google how to link directly to specific timestamps within a video’s URL structure.
- ISO 8601: An international standard for the representation of dates and durations used in schema properties.
VideoObject schema is a specialized code used to provide search engines with detailed information about video content. By implementing this markup, you help crawlers understand a video's title, description, thumbnail, and duration. This metadata is essential for making your content eligible for rich results and advanced features in search results.
What is VideoObject Schema?
VideoObject is a vocabulary from the Schema.org library that describes video files. While search engines attempt to identify video content automatically, adding this markup explicitly defines key attributes for them. Although [video schema is not a direct ranking factor] (Semrush), it provides indirect SEO benefits by making content more visible and interactive.
Google supports both JSON-LD and Microdata formats for this schema, though [Google recommends using JSON-LD] (Semrush) because it is easier to add and maintain without altering the visible HTML structure of the page.
Why VideoObject Schema matters
Implementing VideoObject markup transforms a standard link into an immersive rich result.
- Improved Click-Through Rate (CTR): Rich snippets featuring thumbnails and durations stand out on SERPs, attracting more user interaction than plain text links.
- Increased Discoverability: Marked-up videos can appear in Google Search, Video Mode, Google Images, and Google Discover.
- Enhanced Engagement: Features like Key Moments allow users to navigate directly to specific segments, increasing time spent with your content.
- Better Contextual Understanding: Clear titles and descriptions help search engines rank your video for highly relevant queries.
Required and recommended properties
For a video to be eligible for rich results in Google, you must include specific properties. If these are missing, search engines may fail to extract the information.
Required properties
- name: The title of the video. Use a unique title for every video on the site.
- thumbnailUrl: A URL leading to the video’s unique thumbnail image.
- uploadDate: The first publication date in ISO 8601 format (e.g., 2024-03-31).
Recommended properties
- duration: The length of the video in ISO 8601 duration format (e.g., PT3M20S for 3 minutes and 20 seconds).
- description: A summary of the video content.
- contentUrl: A link directly to the video file (e.g., .mp4).
- embedUrl: A link to the specific video player.
- interactionStatistic: Data regarding views or engagement counts.
Video features and variations
You can nest additional schema types within a VideoObject to unlock specific user interface features on the search results page.
LIVE Badge
By nesting BroadcastEvent inside the VideoObject, you can signal that a video is currently a livestream. This adds a "LIVE" badge to the search result. Google suggests [using the Indexing API] (Google Search Central) to notify them immediately when a stream starts or ends to ensure the badge appears and disappears correctly.
Key Moments
There are two primary ways to mark video segments: 1. Clip Schema: You define the specific start and end times for segments and provide labels for each. 2. SeekToAction Schema: You define your URL’s timestamp structure so Google can automatically link to any point in the video. [SeekToAction is currently supported for 12 languages] (Google Search Central), including English, Spanish, German, and Chinese.
Best practices
Follow these procedures to maximize the impact of your markup:
- Use high-quality thumbnails: Ensure thumbnails are accessible to Googlebot and represent the content accurately. [Thumbnails should be at least 112×112 pixels] (SEO Hacker).
- Be unique: Avoid reusing the same name and description for different videos. This helps prevent confusion during indexing.
- Validate before deployment: Use the Rich Results Test to confirm your code is error-free before publishing.
- Match the page content: Only place video schema on the page where the video is clearly visible to the user.
- Monitor performance: Use Google Search Console’s Performance Report to [filter traffic by Search Appearance > Videos] (Semrush).
Common mistakes
Mistake: Using the wrong date or duration format. Fix: Always use the ISO 8601 standard (e.g., YYYY-MM-DD for dates).
Mistake: Blocking video files or thumbnails via robots.txt. Fix: Ensure Googlebot has permission to crawl the content and thumbnail URLs.
Mistake: Missing the endDate for livestreams.
Fix: For BroadcastEvent, update the markup once the stream ends to include the actual endDate.
Mistake: Providing a contentUrl that links to a webpage.
Fix: The contentUrl must point directly to the actual bytes of the video file (the .mp4 or .webm file).
FAQ
How do I format the video duration correctly?
The duration property requires the ISO 8601 format. You start with "PT," followed by the hours (H), minutes (M), and seconds (S). For example, a video that is 1 hour and 15 minutes long would be formatted as PT1H15M.
Can I use VideoObject schema for YouTube videos?
Yes. Google often detects Key Moments for YouTube videos automatically from the description. However, to ensure accuracy, you should [format timestamps as [hour]:[minute]:[second]] (Google Search Central) on a new line within the description.
What is the difference between contentUrl and embedUrl?
contentUrl points to the raw video file, while embedUrl points directly to the video player itself (the source of the iframe). Google uses these to understand where the video lives and how it is played.
Does video schema help with ranking?
It is not a direct ranking factor. However, it significantly helps with indexing and increases the likelihood of appearing in Video Mode and Discover, which can drive more organic traffic.
How do I test my video markup?
You can use the [Schema Markup Validator] (Schema.org) for general syntax or the Rich Results Test to see specifically which video features your page qualifies for.
