instruction-in-name

Accessible names should not contain instructions or usage hints.

Who might be affected

Screen Reader

Voice Control

Description

Accessible names are intended to provide the user with information about the context and purpose of the element, and should not contain other information such as hints or instructions on how to activate them. Screen readers and other assistive technologies will provide this information by default based on the type of element and the event listener attached to it.

Quick Fixes

For Android

Ensure that the accessible names of controls do not include the following terms:

Double-tap
Tap
Press Select Switch
Press select
Activate
Long press
to toggle
to edit text
to change
Swipe with two fingers to switch pages
Use volume keys to adjust
Collapse
Start drag
Drop dragged item
Cancel drag
Drag started
Dragged item dropped
Drag canceled
Swipe left
Swipe right
Swipe up
Swipe down

For iOS

Ensure that the accessible names of controls do not include the following terms:

Double tap
Swipe up or down
Use the rotor

How Users Are Affected

Ensure that the accessible names of controls do not include the following terms:

When the accessible name contains instructions about the control's operation, it may cause a stuttering effect for screen reader users since the instructions will be declared based on both the element's semantics and the accessible name. In some cases, confusion may arise if the instructions in the name do not match or even contradict those from the element itself.

WCAG Success criteria

This issue might cause elements to fail one or more of the following Success criteria:
Best Practice