Rule ID: ace-struct-frame-title

Verify that iframe and frame elements have an accessible name via the title attribute

WCAG 2.0 (A) - WCAG 2.2 (A) 4.1.2: Name, Role, Value Blind Deafblind Mobility Legal Risk

What This Rule Checks

For users who rely on assistive technologies, such as screen readers, frames (or iframes) need to have descriptive and unique titles. The title attribute helps convey the purpose or content of the frame, making navigation easier and clearer. Without a unique title, users may struggle to understand what information the frame contains, leading to confusion.

Who Is Affected

This issue primarily affects: Blind users, who rely entirely on screen readers or braille displays to navigate and interact with content; Deafblind users, who rely on braille displays and cannot access visual or auditory content; Mobility users, who navigate using keyboards, switches, voice control, or other assistive input devices.

Why This Matters

Without a title, screen reader users encounter an embedded frame with no indication of its content. They must navigate into the frame to discover what it contains, then navigate back out if it wasn’t what they were looking for. This violates WCAG 4.1.2.

How to Fix

Add a Title Attribute: Ensure every frame or iframe has a title attribute that describes the content or purpose of the frame.

Ensure Titles Are Unique: If multiple frames are used on a page, each should have a distinct title that reflects its content.

Code Examples

Incorrect Markup Solutions:

Code example

<!-- iframe with no title -->
<iframe src="payment-form.html"></iframe>

Copy

Correct Markup Solutions:

Code example

<!-- iframe with descriptive title -->
<iframe
  src="payment-form.html"
  title="Secure payment form">
</iframe>

Copy

Common Mistakes to Avoid

Forgetting the title attribute on iframes entirely.
Using vague titles like “frame” or “embedded content”.
Adding aria-label instead of title (both work, but title is the standard approach for frames).

AI Auto-Fix Available

This rule supports ACE™ AI Auto-Fix. When a violation is detected, ACE can automatically generate a code fix for review. The AI analyzes the specific element in context and proposes a targeted remediation that preserves your existing markup and styling. You can preview, modify, and approve the fix before it is applied.

Tip: Proper document structure enables assistive technologies to present content meaningfully. Headings, lists, and semantic HTML elements create a navigable outline of the page that screen reader users depend on.

Related WCAG Criteria

• 4.1.2: Name, Role, Value