Skip to content
regensbot
DEV-VID-03Should3 of 6 in VID

Describe videos with VideoObject markup and mark key moments with Clip or SeekToAction

Level
Should

Recommended: skip it only for a reason you can name.

Documentation

Documented

At least one cited Google document states or supports it.

Covered

Automatic

Decided from one URL.

Why it matters

Google strongly suggests describing a video's metadata with JSON-LD in addition to the HTML element. Video features such as key moments and previews build on it: Clip markup gives exact segments, and SeekToAction tells Google how timestamps appear in your URLs.

How to meet it

VideoObject with name, description, thumbnailUrl, uploadDate in ISO 8601, duration, and contentUrl or embedUrl; hasPart Clip items with name, startOffset, endOffset and a url pointing at the same watch page at that second. Keep thumbnails crawlable and make them show the video's real content: said at Search Central Live, Google's experiments show a very high drop-out at the start of videos whose thumbnail is wrong.

How to test it

The Rich Results Test detects the video and its clips, and the Video indexing report shows it as indexed.

How Regensbot covers it

AutomaticNeedsOne URL

Decided from one URL.

An audit reads the response, the headers, the HTML, robots.txt, the sitemaps and the structured data, and the finding shows the evidence it saw.

How verdicts workWhat you connect

Sources

Google documents02

  1. 01Video SEO best practicesGoogle Search Central (opens in a new tab)
  2. 02Introduction to structured data markup in Google SearchGoogle Search Central (opens in a new tab)

Claims in the knowledge base03

  1. D2-C551ConsistentUsing images to your advantage and Engaging Search users with videosSaid on stage
  2. D2-C550ConfirmedUsing images to your advantage and Engaging Search users with videosSaid on stage
  3. D2-C917UndocumentedUsing images to your advantage and Engaging Search users with videosSaid on stage

Claim IDs refer to the Search Central Live 2026 knowledge base. The knowledge base (opens in a new tab)

Confirmed
Google's documentation states the same thing.
Consistent
Google's documentation supports it without stating it.
Undocumented
Said or shown at the event, not in the documentation.

Audit

Check it on your site.

One audit checks a URL against all 138 requirements and returns one finding for each, with its source. One URL decides 66; for each of the others, the finding says which source to connect.