Avoiding Role Words in Accessible Names
Avoiding Role Words in Accessible Names records a distinct W3C-supported interface-writing task while keeping implementation mechanics outside the writing guidance.
Do not add generic role words such as “button” or “navigation” to an accessible name when assistive technology will already announce the role.
Key details
Important caveats
Scope Boundary
A role word can still be meaningful when it is part of the actual proper name or user-facing phrase; the rule targets redundant role labeling.
Further guidance
Content
Write the identifying purpose only; omit generic role words such as “button,” “image,” or “navigation” when the platform will announce that role.
Purpose
Removing duplicated role words avoids repetitive screen-reader output and keeps the name focused on what distinguishes the element.
Sources and evidence
Sources are shown with the role they play in this guide. Historical or style-sensitive claims are kept within the evidence boundary described above.
- Providing Accessible Names and Descriptions — W3C WAI ARIA APG (opens in a new tab)W3C Web Accessibility Initiative · W3C WAI-ARIA Authoring Practices guidance for descriptive accessible names, visible labels, and button/control naming.