Document video SEO: what actually gets indexed

What a crawler sees

Not the video. A search engine indexing your page sees the page's HTML, the structured data, and — where you provided it — the transcript and caption file. The MP4 itself contributes almost nothing.

This is the whole basis of video SEO and it is consistently misunderstood. Ranking is not a reward for a good video; it is a consequence of the text surrounding it being good and specific.

• Page title and heading structure.
• VideoObject structured data — name, description, thumbnail, duration, upload date.
• The transcript, if it is on the page as text.
• The caption file, where the platform indexes it.

Put the transcript on the page

The single highest-return action, and the most commonly skipped. A ten-minute video is 1,500 words of specific, on-topic text. Published on the page below the player, that text is indexable, quotable, and answers long-tail queries the video's title never could.

It also helps real people: a meaningful share of visitors will scan the transcript rather than watch, which is a completed visit rather than a bounce.

If you generated the video from a script, this text already exists. Publishing it costs nothing.

VideoObject structured data

Structured data is how a page tells a search engine that it contains a video and what the video is. Without it, a page with an embedded player often reads as a page with an image.

Include name, description, thumbnailUrl, uploadDate, duration, and contentUrl or embedUrl. The description here is a separate field from your page's meta description and should be written for it, not copied.

Do not compete with yourself

A specific and common mistake with document video: publishing the video on its own page, with a title and description almost identical to the PDF's landing page. Now two of your pages target the same query and both rank worse than one would.

Embed the video on the document's existing page instead. One URL, both formats, all the signals consolidated. If the video genuinely warrants its own page — a series episode, say — make sure its title targets a different query.

The YouTube-versus-self-hosting trade

YouTube gives you discovery and costs you the page. A YouTube-hosted video embedded on your site sends engagement signals to YouTube's page, not yours, and the ranking video in search results is often YouTube's URL rather than yours.

Self-hosting keeps the signals but gives up YouTube's discovery entirely. Most teams should do both — upload to YouTube for discovery and embed a self-hosted copy on the document's canonical page — accepting the small duplication cost for the coverage.

Frequently Asked Questions