Writing & StyleStyle guide

Writing Accessible Listbox Labels

Writing Accessible Listbox Labels records a distinct W3C-supported interface-content task while keeping implementation mechanics outside the writing guidance.

Quick answer

Give a standalone listbox a concise label that describes the set of choices as a whole, separate from the individual option names.

Key details

Core IssueW3C APG says a standalone listbox has either a visible label referenced by aria-labelledby or a value supplied with aria-label.
Registerweb accessibility and interface content

Important caveats

Scope Boundary

This page covers the overall listbox label; individual option wording and option-group labels remain separate writing tasks.

Further guidance

Content

Write the listbox label as a concise description of the choice the list controls, such as destination, department, or category, rather than repeating individual option text.

Purpose

A clear listbox name gives users the shared context needed to interpret the individual options that follow.

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. Listbox Pattern — WAI-ARIA Authoring Practices Guide (opens in a new tab)World Wide Web Consortium (W3C) · W3C APG guidance for listbox and option-group accessible naming, plus concise option wording and repeated-prefix cautions.

Related guides

Writing & Style

Writing Accessible Listbox Option Labels

Writing Accessible Listbox Option Labels captures the APG’s explicit content guidance on spoken option names rather than duplicating generic form-label advice.

Explore the topic