Frames must have a unique title attribute
iframe elements in the document must have a unique title to describe their contents to screen reader users.
Why it Matters
Screen reader users rely on a frame title to describe the contents of the
frame. Navigating through frames and iframes can quickly become difficult and confusing for users of this technology if the frames are not marked with a
How to Fix the Problem
iframe elements have titles that are not repeated.
You can add a title attribute to a frame element as follows:
<iframe ... title="myFrame"> frame body </iframe>
Additionally, best practice is to give the enclosed document a
title element with content identical to the title attribute. Some screen readers will replace the contents of the title attribute on the frame with the contents of the
title element inside the frame. As a result, it’s safest and most accessible to have the same text in both locations.
A good title is brief, clear, informative, and unique. Ensure that the document’s
title contains short, descriptive text summarizing the page’s contents. To pass this rule, it’s not sufficient to simply have a
title element; the element must also contain meaningful text.
Best practices when writing frame titles
- Replace placeholder titles such as “untitled page” with a more appropriate phrase
- Make each title unique – don’t duplicate titles across pages, even if they are similar.
- Put all unique information first. If you want to include the company’s name or brand in the title, this information should go after the unique content. Otherwise, users of screen readers will have to listen to this information over and over as they search for the page that interests them.
- Make the page title match the top heading (ideally labelled as h1) on your page. These don’t need to be identical, but it often makes sense to make them very similar, since the
h1elements serve essentially the same purpose.
The Algorithm (in simple terms)
Ensure that all
frame elements contain a unique and non-empty title attribute.