Writing & StyleStyle guide

Writing Accessible Toolbar Labels

Writing Accessible Toolbar Labels records the APG-supported naming task for toolbar containers and keeps it distinct from labels on the individual buttons or controls inside the toolbar.

Quick answer

Give a toolbar a concise label that describes the purpose of the controls it groups.

Key details

Core IssueW3C APG requires a toolbar container to use a visible label via aria-labelledby or an accessible label via aria-label.
Registerweb accessibility and interface content

Important caveats

Scope Boundary

This page covers toolbar-name wording; arrow-key behavior, focus management, control order, and orientation remain implementation concerns.

Further guidance

Content

Label a toolbar by the purpose of the grouped controls so users can identify what that toolbar is for.

Purpose

A purpose-based toolbar label helps users understand the function of the control group when navigating composite widgets.

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.

  1. Toolbar Pattern — WAI-ARIA Authoring Practices Guide (opens in a new tab)World Wide Web Consortium (W3C) · W3C APG guidance for giving a toolbar an accessible label that describes the grouped controls.

Explore the topic