For AI agents and LLMs: a machine-readable index is available at llms.txt. A plain-Markdown version of any documentation page is available by appending .md to its URL.
Skip to main content

Redundant State Keyword in Accessibility Label

Accessible labels shouldn't bake in state words like "on", "off", or "selected" that TalkBack already announces from the control itself.

WCAG Reference

Maps to: WCAG 4.1.2 Name, Role, Value | Applies to: WCAG 2.0, WCAG 2.1, WCAG 2.2 Introduced in: WCAG 2.0 | Level: A | Read the official specification →

What this rule checks

The scanner flags accessible names that embed the control's state — words like "on", "off", "checked", "selected", "disabled" — on controls whose state TalkBack already announces automatically. Only state words TalkBack actually speaks for that control type are flagged: "on"/"off" for switches and toggles, "checked"/"not checked" for checkboxes, "selected" for selected elements, and "disabled" for disabled interactive elements.

Why it matters

TalkBack derives state from the control itself and appends it to every announcement. When the state is also written into the label, users hear it twice — "WiFi ON, on, Switch". Worse, the hardcoded state does not update when the control changes: after toggling, TalkBack announces "WiFi ON, off, Switch" — the label now contradicts the real state, and the user cannot tell which is true.

Common failure patterns

  • toggle labels that bake in the current state: "Dark mode off", "Notifications ON"
  • labels updated manually in code to mirror state instead of relying on the control's state APIs

Remediation guidance

  • audit dynamic text and remove status words like "On", "Checked", or "Expanded" from the label string
  • stabilize the label — keep it static (e.g., "Notifications") rather than describing its current state
  • map state to platform APIs instead — use stateDescription or android:checked="true" so TalkBack announces it correctly and it stays in sync

Test across 3000+ combinations of browsers, real devices & OS.

×
Schedule Your Personal Demo
Book Demo

Help and Support

Related Articles