Skip to content
BENIBIX Learn

Accessible Name

Design♿ AccessibilitySemantic Structure

Also known as aria-label, Accessible Label, Control Name

The name a screen reader says for a control, like Search or Close.

Think of it like

It is like the name a friend calls out for you. Without it, nobody knows who to look for.

Example

A row of icon buttons reads as button, button, button. After adding names, it reads as Edit, Share, Delete.

Why it matters

A control with no name is a guess. People cannot use what they cannot name.

Definition

An accessible name is the name a screen reader says for a control, like Search for a search button. It most often comes from the text you see, the field label, or a picture's alt text. When there is no text to see, as on an icon button, it can be added with an ARIA label. A control with no name is read as just button. That tells people nothing.

Example code

html
<button aria-label="Close">
  <svg aria-hidden="true">...</svg>
</button>
The icon is hidden from screen readers and the button is named Close instead.

Common mistake

Giving a name that differs from the visible label. Voice users say what they see, so match it.

Key takeaways

  1. 1
    What is spoken. For each control.
  2. 2
    From visible text first. Label, content, alt.
  3. 3
    Match what is shown. Voice users say it.

Compare