Writing & StyleStyle guide

Writing Accessible Progressbar Labels

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

Quick answer

Give the progress indicator a concise label that identifies what process or operation the progress value belongs to.

Key details

Core IssueW3C APG says a progressbar needs an accessible name; a visible label can provide that name, otherwise an accessible label is supplied directly.
Registerweb accessibility and interface content

Important caveats

Scope Boundary

This page covers the progressbar’s accessible name, not its numeric or user-friendly value text, which is a separate writing task.

Further guidance

Content

Write the label to identify the progress task or process so users can distinguish it from other indicators.

Purpose

Clear wording helps assistive-technology users understand the component or content in context without relying on implementation details.

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. Providing Accessible Names and Descriptions — W3C WAI ARIA APG (opens in a new tab)W3C Web Accessibility Initiative · W3C WAI-ARIA Authoring Practices guidance for descriptive accessible names, visible labels, and button/control naming.

Explore the topic