Writing Accessible Progressbar Labels
Writing Accessible Progressbar Labels records a distinct W3C-supported interface-content task while keeping implementation mechanics outside the writing guidance.
Give the progress indicator a concise label that identifies what process or operation the progress value belongs to.
Key details
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.
Practical Application
Label the progressbar for the process whose completion is being measured, not with the generic word “progress”; keep changing percentages or step counts in the value information.
Purpose
Clear wording helps assistive-technology users understand the component or content in context without relying on implementation details.
Reader Check
If two progress indicators appeared at once, would their labels reveal which operation each one belongs to?
Worked Example
Example: Use “Uploading profile photo” and “Saving account settings” as separate progressbar labels rather than naming both “Progress.”
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.
- 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.