accessaudit

How to fix embedded frames without a title

WCAG 2.4.1 Bypass Blocks and 4.1.2 Name, Role, Value, level A. Rule frame-title in axe-core.

What is wrong

An <iframe> has no title attribute. Screen readers list the frames of a page by their title, so an untitled frame is announced as "frame" with no hint of what is inside. On shop sites these are product videos, store maps, review widgets, chat and payment frames.

Who it blocks

Screen reader users.

How to fix it

<!-- before -->
<iframe src="https://www.youtube.com/embed/..."></iframe>

<!-- after -->
<iframe src="https://www.youtube.com/embed/..." title="Video: how to sharpen a trowel"></iframe>

Frames added by a third-party script are titled in that script's settings, or by the provider. If you cannot change it, tell the provider: the defect is still on your page.

Common mistakes

How the scan proposes a fix

The scan adds a title guessed from the frame address ("YouTube video", "Map", or "Embedded content from" and the host), runs the same rule on the fixed markup, and checks that no existing attribute changed. A title that says what the video or map is about is better.

Check your own pages for free

Drag this button onto your bookmarks bar: Scan with accessaudit. Then open a page of your shop and click the bookmark: a score and the three main defects appear in a few seconds. The check runs in your browser: no content of your page leaves it, only the scanner is downloaded from this site. Try it on a demo shop.