How to Fix "Frames Have Titles": Add Iframe Title Attributes

Screen readers announce iframes by their title attribute. When an iframe has no title, or several frames share the same title, users hear "frame" with no context. This guide shows how to find every frame on your pages, give each one a unique, descriptive title, and handle embeds injected by third-party scripts.

By Updated ⏱ 15–30 minutes🎯 Beginner● Low impactAccessibility
Illustration: Frames have titles fix guide
ACCESSIBILITY · FIX GUIDE Frames have titles IMPACTEFFORT TIME15–30 minutes LEVELBeginner

Why it matters

Screen reader users often move through a page by jumping between frames and landmarks. An untitled YouTube embed, map or chat widget gives them no clue what it holds, so they have to enter it to find out. Duplicate titles cause the same confusion when two frames have the same name but different content.

2 (Name, Role, Value) and are a common item in accessibility complaints and procurement audits. The fix rarely takes more than a few minutes per template, and it also gives crawlers and AI tools a readable label for embedded content.

✕Before<iframesrc="https://www.youtube.com/embed/abc123"></iframe>is announced only as "frame", and two✓After<iframesrc="https://www.youtube.com/embed/abc123"title="Video: How Example Co installs

What you need

Access to edit your theme templates, page builder embeds or site code
A desktop browser with DevTools (Chrome, Edge or Firefox)
The axe DevTools browser extension or Lighthouse, for re-testing
A list of the third-party widgets on your site (video, maps, forms, chat, payments)

Step-by-step fix

1

List every frame on the page

Open the failing page, press F12 and go to the Console tab. Paste the snippet below and press Enter. It lists every iframe and frame with its title and source, and flags frames that have no title or share a title.

Repeat this on each template type, such as home, product, blog post and contact page, because embeds often differ between templates.

javascript
const frames=[...document.querySelectorAll('iframe, frame')];const counts={};frames.forEach(f=>{const t=(f.getAttribute('title')||f.getAttribute('aria-label')||'').trim();counts[t]=(counts[t]||0)+1;});console.table(frames.map(f=>{const t=(f.getAttribute('title')||f.getAttribute('aria-label')||'').trim();return{title:t||'(MISSING)',duplicate:t&&counts[t]>1?'YES':'',src:f.src||'(inline)'};}));
Pro tip: Frames with a blank src or an about:blank src are usually created by scripts. Note them down; you will fix them in step 5.
2

Write a short, specific title for each frame

A title should tell the user what is inside the frame before they enter it. Use the format type: specific content. Keep it under about 60 characters.

Avoid placeholder text such as "iframe", "embed", "frame" or "untitled". These count as a title, but they tell the user nothing.

  • Video: "Video: Example Co product tour"
  • Map: "Map: Example Co head office, 1 High Street"
  • Form: "Newsletter sign-up form"
  • Widget: "Customer support chat"
Pro tip: If a heading on the page already describes the embed, reuse its wording in the title so the page reads consistently.
3

Add the title attribute to hard-coded iframes

Find the iframe in your template, custom HTML block or embed code and add a title attribute. Apply this to every embed code you paste in, including YouTube, Vimeo, Google Maps, Calendly and Typeform. Most of these share buttons leave the title out or fill it with something generic.

html
<iframe src="https://www.google.com/maps/embed?pb=EXAMPLE" title="Map: Example Co head office, 1 High Street" width="600" height="450" loading="lazy" style="border:0"></iframe>
Pro tip: The audit also accepts `aria-label` or `aria-labelledby` as the name. `title` is still the safest choice because every screen reader supports it.
4

Make duplicate titles unique

The check also fails when two frames on the same page share a title but load different content. For example, two videos both titled "YouTube video player" will fail. Add the subject or location to each title so they can be told apart.

Frames that load the exact same URL can share a title, but it is cleaner to make them unique anyway.

html
<iframe src="https://www.youtube.com/embed/abc123" title="Video: Installing the Example Co X1"></iframe>
<iframe src="https://www.youtube.com/embed/def456" title="Video: Cleaning the Example Co X1 filter"></iframe>
Pro tip: In loops, such as product galleries or blog listings, build the title from data like the product name, not from a fixed string.
5

Label frames injected by third-party scripts

Chat widgets, ad slots, review badges and payment fields often create iframes with JavaScript, so you cannot edit their HTML directly. First check the vendor's settings for an accessibility or title option, and upgrade to the latest embed version. If neither helps, add a small script that sets a title on any untitled frame matching the vendor's source URL.

Load it site-wide, for example through your theme footer or a Custom HTML tag in Google Tag Manager on All Pages.

html
<script>
(function(){
  var rules=[
    {match:'widget.example-chat.com', title:'Customer support chat'},
    {match:'reviews.example-reviews.com', title:'Customer reviews widget'}
  ];
  function label(){
    document.querySelectorAll('iframe:not([title])').forEach(function(f){
      rules.forEach(function(r){ if((f.src||'').indexOf(r.match)>-1){ f.setAttribute('title', r.title); } });
    });
  }
  label();
  new MutationObserver(label).observe(document.documentElement,{childList:true,subtree:true});
})();
</script>
Pro tip: Report the missing title to the vendor as well. A vendor fix survives their updates, while your script depends on their source URL staying the same.
6

Handle invisible tracking and helper frames

Some scripts add hidden 1×1 iframes for tracking or cross-domain storage. If a frame is hidden with display:none or visibility:hidden, assistive technology skips it and it does not need a title. If it is visible to the accessibility tree but has no meaningful content, give it a plain title such as "Analytics helper (no content)" so it still passes.

Do not add aria-hidden="true" to a frame that contains focusable content.

html
<iframe src="https://tracking.example.com/sync" title="Tracking helper (no content)" width="1" height="1" style="position:absolute;border:0" tabindex="-1"></iframe>
7

Re-test the page with axe or Lighthouse

Clear any page or CDN cache. Then open the page in a private window and run the axe DevTools extension (Scan ALL of my page). Confirm there are no results for Frames must have an accessible name or Frames must have a unique title attribute.

You can also run Lighthouse from DevTools (Lighthouse > Accessibility > Analyze page load) and check that "<frame> or <iframe> elements have a title" passes. Finally, re-run your site audit to confirm the fix across all templates.

Pro tip: Script-injected frames can load several seconds late. Wait until widgets are visible before you scan, or the scan may miss them.

Platform-specific notes

WordPress

In the block editor, the YouTube and Vimeo Embed blocks usually output the video's own title. Custom HTML blocks and page builders such as Elementor (HTML widget) and Divi (Code module) keep whatever iframe code you paste, so add the title there. For embeds created by plugins, check the plugin's settings or use the script from step 5 via your child theme's footer.php or a code snippets plugin.

Shopify

Go to Online Store > Themes > ... > Edit code and search sections and snippets for "<iframe". Video sections often use the video_tag or external_video_tag filters. You can pass a title to these, for example {{ section.settings.video | external_video_tag: title: section.settings.heading }}. Iframes from apps are injected by app embeds, so ask the app developer for a fix or use the step 5 script in theme.liquid before </body>.

Webflow

The native Video element produces an iframe whose title you cannot always set. Check the published output. If the title is missing or generic, replace the element with an Embed element and add the iframe with your own title attribute. Site-wide fixes for injected frames go in Site settings > Custom code > Footer code.

Wix

In Wix, you add your own embeds through Add Elements > Embed Code > Embed HTML. Wix wraps that code in its own iframe. Set the title in your own code, then check the outer frame in DevTools. If the Wix-generated wrapper lacks a title, you cannot edit it directly. Report it to Wix support and note it as a platform limitation in your audit.

Next.js / React

Pass title as a JSX prop: <iframe src={url} title={`Video: ${video.name}`} />. Add the jsx-a11y/iframe-has-title ESLint rule (included in eslint-config-next) so builds flag missing titles. For third-party components such as react-youtube, use the component's title or iframe props option if it has one.

Check that it worked

✅ How to verify

  • Run the DevTools console snippet from step 1 again and confirm no rows show (MISSING) or duplicate = YES.
  • Run the axe DevTools extension and confirm the 'frame-title' and 'frame-title-unique' issues no longer appear.
  • Use a screen reader (NVDA or VoiceOver) to tab or jump to each embed (frame navigation key M in NVDA browse mode) and confirm it announces the descriptive title.
  • Re-run your site audit and confirm the 'Frames have titles' check passes on every template, not only the page you fixed.

⚠️ Common mistakes

  • Using generic titles such as "iframe", "embed" or "YouTube video player". The check may pass, but users get no useful information, and duplicates of these titles fail the uniqueness test.
  • Fixing one page in the editor when the iframe actually comes from a shared theme section, app or plugin. The same issue then remains on dozens of other URLs.
  • Testing before third-party widgets have loaded, which misses frames injected by script a few seconds after page load.
  • Adding aria-hidden="true" to a visible embed to silence the warning. This hides real content such as a video, form or map from screen reader users.

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 all iframes need a title attribute?

Every iframe that assistive technology can reach needs an accessible name. A title attribute is the most reliable way to give it one. Frames hidden with display:none or visibility:hidden are skipped by screen readers and do not need one.

Is aria-label better than title on an iframe?

Both give the frame an accessible name, and the audit accepts either. title has broader support across screen readers and browsers, so use title. Add aria-label only if you have a specific reason to.

Does the iframe title affect SEO?

Not directly as a ranking factor. However, it is a readable label that helps crawlers and AI tools understand what the embed contains, and it improves accessibility scores in tools such as Lighthouse.

Can two iframes have the same title?

Only if they load the same content. Frames with identical titles but different content fail the uniqueness test, so add a distinguishing detail such as the video topic or office location.