Writing Accessible Switch Descriptions
Writing Accessible Switch Descriptions records a distinct W3C-supported interface-content task while keeping implementation mechanics outside the writing guidance.
When a switch label alone does not explain the effect, use a short optional description to clarify what the setting changes without replacing the stable switch name.
Key details
Important caveats
Scope Boundary
This page covers optional switch-description wording; the switch label remains the primary accessible name and must stay stable as state changes.
Further guidance
Content
Write the description as extra context about the effect or consequence of the setting, not as a second label or a restatement of the on/off state.
Purpose
Clear wording helps assistive-technology users understand the component or content in context without relying on implementation details.
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.