Rampsight

All rules

Text alternatives

Frame titles must be distinct

Why it matters

Screen readers list frames by title. Three frames called "Video" give no way to choose between them.

How to fix it

  1. Give every iframe on the page a title that says what is in it.
  2. Include the distinguishing detail — "Product tour video", not "Video 1".

In markup

Fails
<iframe src="/a" title="Video"></iframe>
<iframe src="/b" title="Video"></iframe>
Passes
<iframe src="/a" title="Product tour video"></iframe>
<iframe src="/b" title="Customer story video"></iframe>

The requirement behind it

This rule is one way of failing the following WCAG 2.2 success criteria. The W3C, which writes the standard, explains each of them:

Further reading

Deque University on frame-title-unique (opens in new tab)

Deque maintains axe-core, the open-source engine our scanner runs. Their page documents the rule as the engine implements it.

Automated checks find failures a browser can prove. They cannot judge whether a caption is accurate, whether an alt text is useful, or whether a page can be operated end to end with a keyboard — those need a person.