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.

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. 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.
What you need
Step-by-step fix
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/embedoryoutube-nocookie.com/embedplayer.vimeo.comfast.wistia<video
Custom Search rules (Contains): youtube.com/embed youtube-nocookie.com/embed player.vimeo.com fast.wistia <video
Get a draft transcript from the video source
Do not type it from scratch. 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.
pip install -U openai-whisper whisper demo-video.mp4 --model medium --language en --output_format all
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.
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.
vtt file.
<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 > 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>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.
<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>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.
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.
curl -s https://example.com/features/reporting | grep -c "build a weekly report"
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 freeFAQ
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.
How to Fix Missing Image Width and Height Attributes
How to Add a Table of Contents to Long Pages and Articles
How to Fix Too Many On-Page Links (Over 150 per Page)
How to Fix a Missing Call-to-Action Above the Fold
How to Fix Hreflang Tags: Add Self-References and x-default
How to Fix a Missing Viewport Meta Tag on Every Page