Products SEO & GEO Agent Paid Ads Agent Website Agent Conversion Agent
How it works Pricing FAQ Blog Book a call

Video SEO for websites: VideoObject schema and key moments

Updated · 6 min read

Short answer Google shows a video from your site only when the page's main purpose is that one video, the page itself is indexed and doing well in Search, and Google can find a thumbnail and the video file. Give each important video its own page, add VideoObject markup with a name, thumbnail and upload date, and check it in Search Console.

Want help applying this to your business? Talk it through on a free 30-minute call.

Book a call

Put it on a page built around that one video, and make sure Google can reach the page, the thumbnail and the video file. Google's Video SEO best practices list the conditions:

ConditionWhat it means for you
The page is indexedIt shows in Search already; check in Search Console
The page performs well in SearchGoogle says the page must be "performing well in Search before its video can be considered for indexing"
The video is embedded on a watch pageOne video is the reason people visit the page
The video isn't hiddenNot behind a tab, popup or other element
A valid thumbnail at a stable URLAt least 60x30 pixels, larger preferred
A supported file typeMP4, MOV and WebM all work; data URLs don't
The video file isn't blockedDon't block it with robots.txt or noindex

The second row surprises people. A video can't rescue a page Google doesn't already rate: fix the page first, then add the video.

What is a watch page?

A page whose main job is to show one video. Google's own definition:

"A watch page's main purpose is to show users a single video." (Google Search Central: Video SEO best practices)

Google's examples of pages that are not watch pages include a blog post that reviews an embedded video, a product page with a 360 video, and a video category page listing several videos of equal prominence. For a service business, this decides the setup:

PageWatch page?What Google can show
"Video: how we replace a water heater", video at the top, short text belowYesVideo result, with thumbnail and key moments
Water heater service page with a short clip halfway downNoA normal text result
A "Videos" page with a grid of 12 clipsNoA normal text result
A homepage slider of several videosNoA normal text result

Google says it's fine to use the same video on a watch page and on other pages. So keep the clip on your service page for visitors, and give the video its own page if you want it found in video results. A non-watch page can still rank as text, or appear in Google Images with a video badge.

No. A slider of several videos is, in Google's terms, a page where no single video is the main content, so none of them qualifies for video features. The "video carousel" in Google's results is a row Google fills itself. You can't request it, and Google removed its old limited-access carousel markup from its documentation in April 2024 (Google Search Central: Latest documentation updates).

VideoObject schema: which properties do I need?

VideoObject is structured data: a block of code, usually JSON-LD, that labels the video's facts so Google doesn't have to guess. Google's video structured data page requires three properties and recommends more:

PropertyRequired?What to put in it
nameRequiredThe video's title, unique on your site
thumbnailUrlRequiredLink to the thumbnail image file
uploadDateRequiredFirst publish date and time, ISO 8601; add the time zone
descriptionRecommendedWhat the video shows, in plain words
contentUrlRecommendedLink to the video file itself, not the page
embedUrlRecommendedLink to the player, if you can't give the file
durationRecommendedLength in ISO 8601, e.g. PT2M30S for 2 minutes 30 seconds
creatorOptionalThe person or business that made the video (added September 2026)
expiresOnly if it expiresDate the video comes down

Google calls contentUrl "the most effective way for Google to fetch your video content files." If your video sits on YouTube, you won't have the file URL; use embedUrl with the YouTube embed link.

Then test the page with Google's Rich Results Test and the URL Inspection tool in Search Console.

How do I get key moments on my video?

Key moments are the labeled jump-to points under a video result. Google can find them three ways:

  1. Automatically. Google "tries to automatically detect the segments in your video" (Google Search Central: Video SEO best practices).
  2. Clip markup. You list each segment with a name, a start time and a URL that opens the video at that second. Google prefers moments you set.
  3. SeekToAction markup. You tell Google how your video's URLs jump to a time, and it picks the moments. Google must be able to fetch the video file, and it works in 12 languages, English, French and Spanish among them.

Both markups need a video of at least 30 seconds that can open at a point other than the start. For a YouTube video, the easy route is timestamps in the YouTube description, one per line in order, each with a label. Google says it will "prioritize key moments set by you, either through structured data or the YouTube description." To turn key moments off, use the nosnippet meta tag.

YouTube or self-hosted: which is better for SEO?

Either can work. With a YouTube embed, Google says it "may index the video both on your web page and on the third-party platform's equivalent page", so your watch page and the YouTube page can compete for the same result. Self-hosting (or a video host that exposes the file) lets you give Google the file URL, which also makes SeekToAction possible; check that your host lets Google fetch the file. For most small businesses, YouTube plus a watch page on your site is the low-cost route.

Do I need a video sitemap?

Not if your watch pages are linked from your site and carry VideoObject markup. Google accepts structured data, video sitemaps or Open Graph tags, and says a video sitemap helps most with videos that are new or that "we might not otherwise discover with our usual crawling mechanisms" (Google Search Central: Video sitemaps). If you use one, it needs a thumbnail, title, description and either the file or player link.

Example

A plumber with ten how-to clips

The clips sit in a slider on a "Tips" page, and none shows in video results. The owner moves each one to its own page with a short summary and VideoObject markup, keeps the clips on the matching service pages, and adds timestamps to the YouTube descriptions.

A dental office with a 20-second tour

The tour is under the 30-second minimum for Clip and SeekToAction markup, so it skips key moments markup. It still gets a watch page and VideoObject markup, so it can qualify for a video result.

A home builder hosting files on its own server

Builds are filmed in 4-minute MP4s. The builder adds contentUrl and SeekToAction, checks robots.txt doesn't block the video folder, and adds a video sitemap because new videos go up weekly.

FAQ

Do transcripts help video SEO?

Google's video documentation doesn't mention them. A short written summary still helps viewers without sound and gives Google text to read.

Why does Search Console say my video isn't the main content?

Since December 2023, Google indexes videos only where they are a page's main content. Give the video a page of its own.

Does video markup improve my ranking?

No. It helps Google understand and show the video; whether the page ranks depends on the page itself.

Can one page have several videos?

Yes, but only a page built around one video counts as a watch page. A page listing several videos of equal weight doesn't.

Different for you?

Keep learning

NextImages not showing in Google? Common causes and fixesWhy your photos don't appear in Google Images or search results: blocked crawling, CSS backgrounds, lazy loading, noindex, CDNs. How to check and fix each.

Do it yourself

On-page SEO checklist: every item to check before publishingA pre-publish on-page SEO checklist for one new page: content, title, headings, URL, images, links, indexing, mobile and speed, plus what to do after launch.

Ask us one question

One line is enough. We reply by email.

Sources

  1. Google Search Central: Video SEO best practices
  2. Google Search Central: Video (VideoObject, Clip, BroadcastEvent) structured data
  3. Google Search Central: Video sitemaps
  4. Google Search Central: Latest documentation updates (video entries, 2024 to 2026)
  5. Google Search Central Blog: Video mode now only shows pages where video is the main content (December 2023)