How to Add Video Captions and Text Descriptions for Charts
This check flags pages that have video or charts but no text equivalent, such as a video without a caption track or a chart image with no description of what it shows. By the end of this guide, every video on your site will have synchronized captions, and every chart will include a written summary and the key numbers in HTML text.

Why it matters
Search engines and AI answer engines can't watch a video or read the bars in a PNG chart. The words spoken in your video and the numbers in your chart only count as content when they also exist as text. Captions also serve deaf and hard-of-hearing visitors, and the many people who watch with the sound off.
2, which matters for ADA and European Accessibility Act exposure. A one-sentence chart summary is often the exact line that gets quoted in a featured snippet or an AI answer.
What you need
Step-by-step fix
List every page with video, audio or charts
Crawl your site and find each page that contains media needing a text equivalent. In Screaming Frog, go to Configuration > Custom > Custom Search and add one search for each of these patterns:
<videoyoutube.com/embedplayer.vimeo.com<canvaschart
Export the results to a spreadsheet. Add columns for "captions present" and "chart described" so you can track your progress.
Create a WebVTT caption file for each video
Generate a first draft with an auto-transcription tool, such as YouTube's automatic captions or the Descript or Otter export. Then correct it by hand. Product names, numbers and speaker changes are where auto-captions usually fail.
vtt extension. The first line must be WEBVTT`.
WEBVTT 00:00:00.000 --> 00:00:03.500 Welcome to Example Co. I'm Dana from the product team. 00:00:03.500 --> 00:00:08.000 In this demo we'll set up your first invoice in under two minutes. 00:00:08.000 --> 00:00:10.000 [upbeat music]
Attach captions to self-hosted videos
Add a <track> element inside each <video> tag. Use kind="captions" and srclang, and give the track a label so users see a readable name in the player menu. vtt files with the text/vtt` content type.
If the file lives on a different domain or CDN, add crossorigin to the video tag and enable CORS on the file.
<video controls preload="metadata" poster="/media/demo-poster.jpg" crossorigin="anonymous"> <source src="https://cdn.example.com/media/demo.mp4" type="video/mp4"> <track kind="captions" src="https://cdn.example.com/media/demo.en.vtt" srclang="en" label="English" default> </video> <p><a href="/media/demo-transcript">Read the full transcript</a></p>
Turn on captions for YouTube and Vimeo embeds
YouTube: open YouTube Studio, go to Subtitles, select the video, then Add language > Add and either upload your .vtt file or edit the auto-generated track. Publish the result. Auto-captions alone are rarely accurate enough to count.
Vimeo: open the video, go to Settings > Distribution > Subtitles (or Transcript in the newer editor) and upload the file. If you want captions on by default, add cc_load_policy=1 to the YouTube embed URL.
<iframe src="https://www.youtube-nocookie.com/embed/VIDEO_ID?cc_load_policy=1&cc_lang_pref=en" title="Example Co invoicing demo (captioned)" allow="encrypted-media; picture-in-picture" allowfullscreen loading="lazy" width="560" height="315"></iframe>
Wrap static chart images in figure and figcaption
Put each chart image inside a <figure>. Write a <figcaption> that states the takeaway, not just the topic. Keep the alt text short and functional, and put the detail in the caption.
For charts with more than a few data points, add the underlying numbers as a real HTML table.
<figure>
<img src="/img/q3-revenue-by-region.png" alt="Bar chart of Q3 revenue by region" width="800" height="450">
<figcaption>Q3 2026 revenue grew 18% to $2.4M. EMEA led with $1.1M, North America followed with $0.9M, and APAC reached $0.4M.</figcaption>
</figure>
<details>
<summary>Chart data</summary>
<table>
<thead><tr><th scope="col">Region</th><th scope="col">Q3 revenue</th></tr></thead>
<tbody>
<tr><td>EMEA</td><td>$1.1M</td></tr>
<tr><td>North America</td><td>$0.9M</td></tr>
<tr><td>APAC</td><td>$0.4M</td></tr>
</tbody>
</table>
</details>Describe SVG, canvas and JavaScript charts
Interactive charts drawn in <canvas> or SVG are invisible to screen readers and most crawlers. Give the chart container role="img" and point aria-labelledby at a visible text summary. Make sure the summary is rendered in the server HTML, not only after JavaScript runs.
Keep the data table fallback from the previous step.
<figure>
<div role="img" aria-labelledby="churn-summary">
<canvas id="churnChart" width="800" height="400"></canvas>
</div>
<figcaption id="churn-summary">Monthly churn fell from 4.2% in January to 2.1% in June 2026 after the onboarding redesign.</figcaption>
</figure>Re-crawl and confirm every flagged page passes
Run your crawl again with the same custom searches. Every page containing video should now also contain a <track kind="captions" element or a captioned embed with a transcript. Every chart should sit inside a <figure> with a <figcaption> or have an aria-labelledby summary.
Then re-run the site audit and confirm the count of failing pages has dropped to zero.
curl -s https://www.example.com/demo | grep -Eo '<track[^>]+kind="captions"[^>]*>|<figcaption[^>]*>[^<]{20,}'Platform-specific notes
WordPress
In the block editor, select the Video block and use **Text tracks** in the toolbar to upload a .vtt file and set its kind to Captions. Image and Chart blocks have a built-in caption field, which outputs <figcaption>. For YouTube embeds, add the transcript in a Details block underneath.
Shopify
Native product media videos don't expose a caption upload in all themes. Either host the video on YouTube or Vimeo with captions enabled, or edit the theme section and replace the `video_tag` output with a manual <video> element that includes a <track> pointing to a .vtt file uploaded under **Content > Files**.
Wix
For Wix Video, open the Video Library, choose the video and use the Subtitles option to upload a .vtt or .srt file. For chart images, add a Text element directly below that states the takeaway, because Wix image captions may not render as <figcaption>.
Webflow
Background Video elements can't carry captions, so never use them for videos that contain speech. Use a YouTube or Vimeo element with captions enabled, or an Embed element containing your own <video> and <track>. Upload the .vtt file through the Assets panel and copy its URL.
Next.js
Put .vtt files in /public so they are served as static files, and render <video> with a <track> child. For client-only chart libraries loaded with dynamic(..., { ssr: false }), render the figcaption and data table outside the dynamic component so they appear in the server HTML.
Check that it worked
✅ How to verify
- Play each video in Chrome and Firefox, open the CC menu, and confirm the English captions appear and stay in sync.
- View the page source (not DevTools Elements) and confirm each <track kind="captions"> and each chart <figcaption> is present in the raw HTML.
- Turn on a screen reader (VoiceOver with Cmd+F5 on macOS, NVDA on Windows), navigate to each chart, and confirm it announces the summary instead of "image" or nothing.
- Re-run the site audit and check that the Captions and chart descriptions check reports no failing pages.
⚠️ Common mistakes
- Relying on YouTube auto-generated captions without correcting them. Misheard product names and numbers make the captions misleading.
- Using kind="subtitles" or kind="descriptions" when the track is a same-language transcript of all the audio. Captions should use kind="captions".
- Writing a chart caption that only names the topic ("Sales by region") instead of stating what the data shows.
- Injecting chart summaries with JavaScript after load, so the text is missing from the HTML that crawlers and AI bots fetch.
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 auto-generated YouTube captions count for accessibility?
Not on their own. WCAG requires captions to be accurate, and auto-captions often get names, numbers and punctuation wrong. Use them as a draft, correct them in YouTube Studio under Subtitles, and publish the edited track.
What is the difference between alt text and a chart description?
Alt text is a short label for the image, such as "Bar chart of Q3 revenue by region." The description, usually a figcaption plus a data table, explains what the data shows and gives the actual numbers. Complex charts need both.
Do videos without speech need captions?
If the video has no meaningful audio, as with a silent product loop, captions aren't needed. Mark it as decorative or describe it in nearby text instead. If it has music or sound effects that convey meaning, caption those in brackets.
Do captions and transcripts help SEO?
Yes, indirectly but measurably. Text in your HTML is what Google and AI answer engines index and quote. A transcript or a chart summary on the page adds relevant, quotable content that the video or image alone can't provide.
How to Fix Missing Contextual Internal Links in Articles
How to Fix Publishing Cadence With a Consistent Blog Schedule
How to Fix Weak Conversion Copy on Your Service Pages
How to Fix Missing Local Landing Pages for Service Areas
How to Fix Brand Voice Consistency Across Your Website
How to Publish Original Research and Data Others Will Cite