Skip to content
ferndean

How-to

How to Embed a YouTube Video Accessibly on a School or Clinic Website

The YouTube embed code is short, but a few lines in it decide whether people can use the video on your page. This walk-through covers each line, the text around the player, and a test you can run this week.

Check your videos free

Published

Why an embedded video counts on your website

When you paste a YouTube player onto a page, that video becomes part of your website. If the page is current, such as a registration page, a clinic services page or this year's board meetings page, the video on it is in scope, even if the upload itself is years old.

Some teams assume an old video is covered by the archived content exception. The DOJ's first-steps guide says older content qualifies only if it existed before the compliance date and sits in a dedicated archive, unchanged and kept only for reference. It also says "just putting content into an archive isn't enough." An old upload embedded on an active page doesn't meet that test. Our guide to the archived video exception walks through all four conditions.

Videos that live only on your YouTube channel and were posted before your deadline are a different case. They are probably exempt (unclear), because neither DOJ nor HHS said whether YouTube counts as social media. Either way, if someone asks for an accessible version of any video, you need to provide one.

As extended in 2026, the ADA Title II deadline is April 26, 2027 for public entities of 50,000 people or more and April 26, 2028 for smaller ones and special districts. The Section 504 deadline for HHS-funded health centers and others is May 11, 2027 with 15 or more employees and May 10, 2028 with fewer. Both rules adopt WCAG 2.1 AA. Check yours with the deadline checker. This post explains the standard; it isn't legal advice.

1. What kind of organization are you?
Answer the questions to see your deadline.

Fix captions and description on YouTube first

The embed is a window onto the video on YouTube. It shows whatever caption tracks and audio tracks the YouTube video has. If the only captions are auto-generated, the embed shows auto-generated captions. If there's no described track, the embed has none.

So the order matters. Fix the video on YouTube, then embed it. When you correct captions in YouTube Studio, every page that embeds that video picks up the fix without any change to your site. Start with how to add captions to YouTube videos, and check speaker names, spelling of local names and anything read off a slide.

The embed code, line by line

Here is what each part of a YouTube iframe does for accessibility, and what you can leave alone.

The iframe title attribute

A screen reader announces the iframe's title when someone reaches the player. YouTube's default embed code often carries a generic title or the raw video name. Replace it with a short, specific label. For example, "Video: How to register for kindergarten" tells a listener what they're about to enter. "YouTube video player" doesn't. If a page has two videos, give each a different title.

Captions on by default: cc_load_policy

YouTube's player parameters page says setting cc_load_policy to 1 "causes closed captions to be shown by default." Add ?cc_load_policy=1 to the end of the embed URL. Viewers can still turn captions off, but people who need them don't have to hunt for the button. This only helps if the caption track is accurate, which is why the step above comes first.

The same page lists cc_lang_pref for choosing a caption language. If you post Spanish captions too, read what that parameter does there and test it before you rely on it.

Autoplay, mute and controls

Leave autoplay out. Sound that starts on its own talks over a screen reader, and motion that starts on its own can distract or disorient. Muting an autoplaying video doesn't solve the motion problem. Keep the player controls visible, and don't add any parameter that hides them. The controls are how keyboard and screen reader users play, pause and turn on captions.

Privacy-enhanced mode

Swapping youtube.com for youtube-nocookie.com in the embed URL is a privacy choice, not an accessibility one. Many public organizations prefer it. If you use it, test that captions and the audio track menu still appear in that player, since YouTube's documentation doesn't say.

Part of the embedHelps WCAG 2.1 AA?What to do
title attributeYesWrite a specific label for each video
cc_load_policy=1HelpsAdd it so captions show by default
autoplayHurts if onLeave it out
Player controlsYesKeep them; don't hide them
youtube-nocookie.comNeutralUse for privacy; test captions and audio tracks
width, height, frameborderNo effectLeave as your site needs
The embed only mirrors the video on YouTube. Accurate captions and description have to be added there.

Autoplay, pause and keyboard checks

Two Level A success criteria apply directly to how a player starts. WCAG 1.4.2 (Audio Control) covers audio that plays automatically for more than a few seconds: people need a way to pause or stop it. WCAG 2.2.2 (Pause, Stop, Hide) covers moving content that starts on its own, which includes muted background video in a page header. The simplest way to meet both is to not autoplay at all.

Then check the player with a keyboard. Put your mouse aside and try this:

  • Press Tab until focus enters the player. You should see where focus is.
  • Press Enter or Space to play, and again to pause.
  • Tab to the captions button and turn captions off and on.
  • Keep pressing Tab. Focus should leave the player and move to the next link on your page, not get stuck.
  • With a screen reader on, listen for the iframe title and for a named play button, not just "button."

If focus disappears or gets trapped, look at your site's own code around the iframe first, such as a lightbox or a custom thumbnail overlay. Those wrappers often cause more trouble than the YouTube player itself.

Audio description on an embedded video

WCAG 1.2.5 asks for audio description when the picture shows something the soundtrack doesn't: steps on a screen, text on a slide, a demonstration with no narration. A talking-head message where the speaker says everything usually doesn't need it. See when audio description is required, or try the check below.

1. What's on the soundtrack?
Answer the questions about one video to see whether it needs audio description.

You have two ways to offer description with an embed.

  • A described audio track on the same video. YouTube Help says creators with Multi-language audio access can upload Audio Description tracks in YouTube Studio, and viewers switch tracks in the player settings. It doesn't say whether embedded or privacy-enhanced players show that menu, so test it on your page.
  • A separate described version, linked next to the player. Upload a second video with description mixed in, and put a clear link such as "Watch the audio described version" right beside the original.

If your embedded player doesn't show the audio track menu, use the second option. Our audio description check can help you sort which videos need it, and how to add audio description to YouTube covers the upload.

The text around the player

The page around the embed does a lot of the work. Put these four things near every video:

  1. 1

    A heading

    Name the video in plain words, so people scanning headings with a screen reader can find it.

  2. 2

    A short description

    One or two sentences on what the video covers and how long it runs. Say if it has captions and audio description.

  3. 3

    A transcript link

    Link to a text version. It helps people who can't watch, and people who want to search for one detail.

  4. 4

    A request link

    Add "Request an accessible version" with a contact who will respond. Our request form template gives you wording to start with.

Copy-ready embed snippet and a 5-minute test

Replace VIDEO_ID, the title, the heading and the links with your own. The example video name below is made up.

Accessible YouTube embed with surrounding text
<h2>How to register for kindergarten</h2>
<p>A 4-minute walkthrough of the online registration form. Captions are on by default.</p>
<iframe
  src="https://www.youtube-nocookie.com/embed/VIDEO_ID?cc_load_policy=1"
  title="Video: How to register for kindergarten"
  width="560" height="315"
  allow="encrypted-media; picture-in-picture; fullscreen"
  allowfullscreen></iframe>
<p>
  <a href="/transcripts/kindergarten-registration">Read the transcript</a> |
  <a href="/video/kindergarten-registration-described">Watch the audio described version</a> |
  <a href="/accessibility/request">Request an accessible version</a>
</p>

Then run this quick test on the live page:

  1. 1

    Load the page

    The video should not start on its own, and captions should appear when you press play.

  2. 2

    Read the captions

    Watch a minute. Are names spelled right and speakers identified? If not, fix them on YouTube.

  3. 3

    Use only the keyboard

    Tab in, play, pause, toggle captions, tab out.

  4. 4

    Check the audio track

    If the video has a described track, confirm the menu appears in this embed. If not, confirm the described-version link works.

  5. 5

    Scan the site

    Run the free website video check to find every embedded video on your site, so you know which pages to test next.

Ferndean is in early access and enrolling pilot districts and health centers for spring 2027. For pilot organizations, it will add checked captions and audio description to videos on YouTube, so every page that embeds them stays current with no change to your embed code. Start today with the free website video check.

Enter your website and we'll check it and the YouTube channel it links to.

Sources

This is a reading of the rules, not legal advice. Something out of date? Tell us and we'll fix it.

Questions

What people ask first.

Something else? Send us a message

Does an old YouTube video embedded on my website need captions?
If it sits on a current, active page, yes. The DOJ says older content qualifies for the archived content exception only if it's in a dedicated archive, unchanged and kept only for reference, and an old upload on an active page doesn't meet that.
How do I make captions show by default on a YouTube embed?
Add ?cc_load_policy=1 to the embed URL. YouTube's player parameters page says that setting causes closed captions to be shown by default. Make sure the caption track on YouTube is accurate first.
What should the iframe title attribute say?
A short, specific label for that video, such as "Video: How to register for kindergarten." Avoid generic text like "YouTube video player," and give each video on a page a different title.
Does youtube-nocookie.com affect accessibility?
It's a privacy setting, not an accessibility one. YouTube's documentation doesn't say whether the audio track menu appears in that player, so test captions and any described track on your page.
Can I fix captions in the embed code?
No. The embed shows whatever caption and audio tracks the video has on YouTube, so fix them in YouTube Studio and every embed picks up the change.

Free video check

How accessible is your video today?

Enter your website. We find the videos embedded on it and scan the YouTube channel it links to: which have accurate captions, which likely need audio description, and how much new video you post a year. Free with your work email.

Enter your website and we'll check it and the YouTube channel it links to.