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.

By Updated ⏱ 20 minutes per video, 5 minutes per chart🎯 Beginner● Low impactContent
Illustration: Captions and chart descriptions fix guide
CONTENT · FIX GUIDE Captions and chart descriptions IMPACTEFFORT TIME20 minutes per video, 5 minutes per chart LEVELBeginner

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.

✕Before<video src="/demo.mp4"controls></video> plus <imgsrc="/q3-sales.png" alt="chart">, with✓After<video> with <track kind="captions"src="/demo.en.vtt" srclang="en"default>, and the chart sits in a

What you need

Access to edit the affected pages (CMS or source code)
The original video files, or admin access to your YouTube or Vimeo account
The data behind each chart (spreadsheet or source table)
A plain text editor for writing .vtt caption files

Step-by-step fix

1

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:

  • <video
  • youtube.com/embed
  • player.vimeo.com
  • <canvas
  • chart

Export the results to a spreadsheet. Add columns for "captions present" and "chart described" so you can track your progress.

Pro tip: Also search for common chart library class names like `highcharts`, `recharts` and `chartjs`. Charts rendered with JavaScript don't show up as images.
2

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`.

text
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]
Pro tip: Include meaningful sounds in square brackets, like [applause] or [alarm beeps]. Captions cover all audio, not just speech.
3

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.

html
<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>
Pro tip: On Nginx, add `types { text/vtt vtt; }` if your mime.types file lacks it. On Apache, add `AddType text/vtt .vtt`.
4

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.

html
<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>
Pro tip: Captions stored inside YouTube aren't in your page's HTML. Paste the transcript below the embed, or in a collapsible <details> block, so crawlers can index it.
5

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.

html
<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>
Pro tip: A caption like "Revenue chart" fails the reader. A caption like "Revenue grew 18%" answers the question the chart exists to answer.
6

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.

html
<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>
Pro tip: Highcharts users can enable the accessibility module (`accessibility: { enabled: true }`). It generates a description and a data table automatically, but you should still write the takeaway yourself.
7

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.

text
curl -s https://www.example.com/demo | grep -Eo '<track[^>]+kind="captions"[^>]*>|<figcaption[^>]*>[^<]{20,}'
Pro tip: Spot-check one video with the sound off. If you can follow the whole thing, the captions are good enough.

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 free

FAQ

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.