Guides โ€บ On-Page

How to Fix Missing Transcripts for Embedded Videos

Your audit flagged pages that embed a video (YouTube, Vimeo, Wistia or a self-hosted <video>) but publish no transcript or text summary of what is said. By the end of this guide every flagged page will have a crawlable transcript in the HTML directly under the video, captions for self-hosted files, and VideoObject markup that references the transcript.

โฑ 20-40 minutes per video๐ŸŽฏ Beginnerโ— Low impactOn-Page
ON-PAGE ยท FIX GUIDE Transcripts for embedded videos IMPACTEFFORT TIME20-40 minutes per video LEVELBeginner

Why it matters

Search engines and AI assistants mostly read text, not audio. A product demo or tutorial with no transcript contributes almost nothing to the page's topical relevance, cannot be quoted in AI answers, and is unusable for deaf or hard-of-hearing visitors and people browsing with sound off. WCAG 2.2 success criteria 1.2.1 and 1.2.2 expect text alternatives and captions for prerecorded media, so missing transcripts are also an accessibility gap. The ranking effect per page is small, but on video-heavy sites the added indexable text adds up.

โœ•Beforehttps://example.com/features/reportingembeds a 6-minute YouTube demo and hasonly two lines of text below it;โœ“Afterhttps://example.com/features/reportingshows the demo followed by an H2"Video transcript" with the full

What you need

Edit access to your CMS or page templates
Access to the video source (YouTube Studio, Vimeo, Wistia or the original file)
A text editor for cleaning up auto-generated captions
Optional: a crawler such as Screaming Frog SEO Spider to list every page with a video

Step-by-step fix

1

List every page that embeds a video

Start from the URLs in your audit report, then confirm you have not missed any. In Screaming Frog go to Configuration > Custom > Custom Search and add rules that match embed code, then crawl the site and export the matching URLs. Prioritise pages that get organic traffic or are product, feature and tutorial pages.

  • youtube.com/embed or youtube-nocookie.com/embed
  • player.vimeo.com
  • fast.wistia
  • <video
text
Custom Search rules (Contains):
youtube.com/embed
youtube-nocookie.com/embed
player.vimeo.com
fast.wistia
<video
Pro tip: If one video is embedded on several pages, write the transcript once and reuse it, but give each page its own short intro so the pages are not near-duplicates.
2

Get a draft transcript from the video source

Do not type it from scratch. In YouTube Studio > Subtitles, select the video, open the language row and use the three-dot menu to Download the auto-generated .srt or .vtt. In Vimeo open the video, go to Distribution or Settings > Subtitles/Transcript and download the auto-captions. For self-hosted files, run an open-source speech-to-text model such as Whisper locally.

text
pip install -U openai-whisper
whisper demo-video.mp4 --model medium --language en --output_format all
Pro tip: Keep the .vtt file: you can reuse it as the captions track for self-hosted video in step 4.
3

Edit the transcript into readable text

Strip the timestamps and line numbers, fix product names and jargon that auto-captions get wrong, and split the text into short paragraphs at topic changes. Add speaker names if more than one person talks, and describe important on-screen content that is not spoken (for example "[Screen shows the Reports > Export menu]"). If the video is long or mostly visual, a detailed written summary with key steps is an acceptable alternative to a verbatim transcript.

Pro tip: Add subheadings that match what people search for ("How to export a report"). They help the transcript rank and make it skimmable.
4

Publish the transcript directly under the video

Place the text in the same page's HTML, immediately after the embed, under a clear heading. It must be present in the server-delivered HTML, not loaded by a script after a click, and not only in a downloadable PDF or a separate page. A native <details> element is fine if you want it collapsed: the text is still in the HTML and crawlable. For self-hosted <video>, also add a captions <track> using the .vtt file.

html
<figure class="video">
  <iframe src="https://www.youtube-nocookie.com/embed/VIDEO_ID" title="Example Co reporting demo" loading="lazy" allowfullscreen></iframe>
</figure>
<section aria-labelledby="transcript-heading">
  <h2 id="transcript-heading">Video transcript</h2>
  <details open>
    <summary>Read the full transcript</summary>
    <p><strong>Dana (Example Co):</strong> In this demo I'll show you how to build a weekly report...</p>
    <p>[Screen shows Reports &gt; New report]</p>
  </details>
</section>

<!-- Self-hosted video -->
<video controls preload="metadata" src="/media/demo.mp4">
  <track kind="captions" src="/media/demo.en.vtt" srclang="en" label="English" default>
</video>
Pro tip: Give every iframe a descriptive title attribute; screen readers announce it and it is a separate accessibility check on most audits.
5

Add VideoObject structured data with the transcript

Add or update JSON-LD for the video and include the transcript property. Google requires name, thumbnailUrl and uploadDate; description, duration, contentUrl or embedUrl are recommended. Keep the transcript in the JSON-LD consistent with the visible text; structured data supplements the visible transcript, it does not replace it.

html
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "Building a weekly report in Example Co",
  "description": "A 6-minute walkthrough of creating, scheduling and exporting a weekly report.",
  "thumbnailUrl": "https://example.com/media/reporting-demo.jpg",
  "uploadDate": "2026-01-15",
  "duration": "PT6M12S",
  "embedUrl": "https://www.youtube-nocookie.com/embed/VIDEO_ID",
  "transcript": "In this demo I'll show you how to build a weekly report..."
}
</script>
6

Upload the edited captions back to the video host

Upload the corrected .srt or .vtt to YouTube Studio (Subtitles > Add language > Upload file > With timing) or Vimeo so the embedded player shows accurate captions. This fixes the in-player experience and keeps the on-page transcript and captions in sync.

Pro tip: Turn on captions by default for embeds with the YouTube parameter cc_load_policy=1 if your audience often watches muted.
7

Check the result

Open the page, use View Page Source (not Inspect) and search for a sentence from the middle of the transcript; it must appear in the raw HTML. Run the URL through Google's Rich Results Test to confirm the VideoObject is valid, then re-run the audit and confirm the page is no longer flagged.

text
curl -s https://example.com/features/reporting | grep -c "build a weekly report"
Pro tip: If curl returns 0 but you can see the text in the browser, the transcript is injected by JavaScript; move it into the server-rendered template.

Platform-specific notes

WordPress

In the block editor add an **Embed** (YouTube/Vimeo) block, then a **Heading** block and either Paragraph blocks or a **Details** block (core since WordPress 6.3) underneath. Avoid transcript plugins or accordions that fetch text via AJAX on click. Yoast SEO and Rank Math can output VideoObject schema; check whether your plugin version supports the transcript field, otherwise add it with a Custom HTML block.

Shopify

For product videos, put the transcript in the product description or a dedicated metafield (Settings > Custom data > Products, type Multi-line text or Rich text) and render it in the product template next to the video section. In the theme editor, a Collapsible content block works if your theme outputs its content in the HTML on load (Dawn and most Online Store 2.0 themes do).

Wix

Add a Text element or a Collapsible Text element directly below the Video Player element in the Editor. Wix Video library captions do not create on-page text, so the transcript must be added as page content. VideoObject markup can be added under Page settings > SEO basics > Advanced SEO > Structured data markup.

Webflow

Place a Rich Text element under the Video or YouTube element. For CMS-driven pages (e.g. a Tutorials collection), add a Rich Text field called Transcript to the collection and bind it in the template, then add VideoObject JSON-LD in Page Settings > Custom Code using collection field references.

Next.js

Render the transcript in a Server Component (App Router) or via getStaticProps/getServerSideProps so it is in the initial HTML. Do not fetch it client-side in useEffect. Output the JSON-LD with a script tag of type application/ld+json inside the page component.

Check that it worked

โœ… How to verify

  • View Page Source on each fixed URL and find a sentence from the transcript in the raw HTML directly after the video embed.
  • Run curl or Google Search Console's URL Inspection > View crawled page to confirm Googlebot sees the transcript text.
  • Validate the VideoObject markup in Google's Rich Results Test and the Schema Markup Validator with no errors.
  • Re-run the site audit and confirm the Transcripts for embedded videos check no longer lists the page.

โš ๏ธ Common mistakes

  • Linking to a transcript PDF or separate page instead of putting the text on the same page as the video.
  • Loading the transcript with JavaScript only after a button click, so it is missing from the HTML crawlers receive.
  • Pasting raw auto-captions with timestamps, wrong product names and no paragraphs, which reads badly and can mislead AI summaries.
  • Relying on YouTube's own captions or the JSON-LD transcript alone; neither puts visible text on your page.

Is this still an issue on your site? Run a free audit โ€” ZORO checks this and 294 other SEO, AI-visibility, accessibility and security signals, with fixes for your platform.

Check my site free

FAQ

Do video transcripts help SEO?

Yes, indirectly. Search engines cannot reliably read speech inside an embedded player, so a transcript turns the video's content into indexable text that can rank for long-tail queries and be quoted in AI answers. The effect per page is modest but real on tutorial and demo pages.

Is a summary enough, or do I need a full transcript?

For SEO and this audit, a detailed written summary of the video's key points is acceptable. For accessibility (WCAG 2.2 level A), prerecorded audio needs a full text alternative or captions, so publish a full transcript where accessibility matters, such as training or support videos.

Will a long transcript cause duplicate content issues if the video is on YouTube too?

No. YouTube's auto-captions are not treated as competing page content. Only reusing the identical transcript across several of your own pages creates near-duplicates; in that case give each page unique surrounding content or keep the full transcript on one canonical page.

Can I hide the transcript in an accordion?

Yes, as long as the text is in the HTML when the page loads. A native details/summary element or a CSS-only accordion is fine; an accordion that fetches the text from a server on click is not crawlable.