Video SEO for websites: VideoObject schema and key moments
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 callHow do I get my video to show up in Google search?
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:
| Condition | What it means for you |
|---|---|
| The page is indexed | It shows in Search already; check in Search Console |
| The page performs well in Search | Google says the page must be "performing well in Search before its video can be considered for indexing" |
| The video is embedded on a watch page | One video is the reason people visit the page |
| The video isn't hidden | Not behind a tab, popup or other element |
| A valid thumbnail at a stable URL | At least 60x30 pixels, larger preferred |
| A supported file type | MP4, MOV and WebM all work; data URLs don't |
| The video file isn't blocked | Don'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:
| Page | Watch page? | What Google can show |
|---|---|---|
| "Video: how we replace a water heater", video at the top, short text below | Yes | Video result, with thumbnail and key moments |
| Water heater service page with a short clip halfway down | No | A normal text result |
| A "Videos" page with a grid of 12 clips | No | A normal text result |
| A homepage slider of several videos | No | A 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.
Does a video carousel on my website help SEO?
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:
| Property | Required? | What to put in it |
|---|---|---|
| name | Required | The video's title, unique on your site |
| thumbnailUrl | Required | Link to the thumbnail image file |
| uploadDate | Required | First publish date and time, ISO 8601; add the time zone |
| description | Recommended | What the video shows, in plain words |
| contentUrl | Recommended | Link to the video file itself, not the page |
| embedUrl | Recommended | Link to the player, if you can't give the file |
| duration | Recommended | Length in ISO 8601, e.g. PT2M30S for 2 minutes 30 seconds |
| creator | Optional | The person or business that made the video (added September 2026) |
| expires | Only if it expires | Date 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:
- Automatically. Google "tries to automatically detect the segments in your video" (Google Search Central: Video SEO best practices).
- 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.
- 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?
- Page not indexed at all: Crawled or discovered, not indexed.
- Other schema for your business: Local business schema markup.
- Where the video fits on a service page: On-page SEO for service pages.
- New to Search Console: Google Search Console for a small business.
- Video for ads instead: YouTube ads for a local business.
- Want it done for you: SEO or Website.