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.

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.
What you need
Step-by-step fix
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.
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)'};}));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"
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.
<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>
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.
<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>
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.
<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>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.
<iframe src="https://tracking.example.com/sync" title="Tracking helper (no content)" width="1" height="1" style="position:absolute;border:0" tabindex="-1"></iframe>
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.
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 freeFAQ
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.
How to Fix "Zooming Disabled" in the Viewport Meta Tag
How to Fix List Structure Errors in HTML (ul, ol, dl)
How to Fix Positive tabindex Values for Keyboard Users
How to Fix Duplicate Element IDs for Accessibility
How to Fix Missing Video Captions on Your Website
How to Fix Invalid ARIA Attributes and Roles on Your Site