Button Name

Link to Button Name copied to clipboard

WCAG 2.0 - 4.1.2 A Impact - Critical

Button Name looks for buttons with a click action and ensures the view is focusable and its name or text is available to TalkBack.

Supported within:
Compose Layouts


People using TalkBack are most affected. The inability to focus on a view or have the view's name announced through TalkBack creates an inaccessible experience.


The version of Android, device, and manufacturer may play a part in issue detection.


  1. Turn on TalkBack
  2. Attempt to focus the control
  3. One of the following will happen:
    • Inaccessible: Unable to focus on the control.
    • Inaccessible: Focused but not announced with TalkBack.
    • Accessible: Focused and announced in TalkBack.

How to Fix

Pair image buttons with a content description or text to indicate its purpose.

fun EmailIconButton() {
        onClick = {},
    ) { 
            painter = painterResource(id = R.drawable.email_icon),
            contentDescription = “Send an Email”

Non-image buttons should provide text for TalkBack.

fun EmailButton() {
        modifier = Modifier.semantics { this.contentDescription = “Send an Email” }
        onClick = {},
    ) { 
            text = “Email”