Frame titles must tell frames apart

Rule frame-title-unique · Document, language & navigation · impact moderate · Static + live

↩ Back to the rules index · WCAG cross-reference

Why it matters#

Screen readers list frames by title. Three frames all called "iframe", or two both called "Video", give the user no way to choose between them — the list becomes a set of identical entries and the only way forward is to enter each in turn.

How to fix#

Title each frame after what it contains — "Location map", "Cookie preferences", "Product tour video" — and keep the titles distinct within a page. Do not use the word "frame"; the role is already announced.

Example#

<iframe title="iframe" src="/a"></iframe><iframe title="iframe" src="/b"></iframe>

<iframe title="Location map" src="/a"></iframe><iframe title="Opening hours" src="/b"></iframe>

WCAG success criteria#

4.1.2 Name, Role, Value — Level A#

Every UI component must expose a correct name, role, and (where relevant) state/value to assistive technology.

Understanding 4.1.2

Standards#

This rule contributes to the following standards:

WCAG A EN 301 549

References#

• WCAG — Name, Role, Value