aria-describedby: Additional Context
What you'll learn: How to link supplementary descriptions to interactive elements so screen readers provide helpful context beyond the main label.
The Core Idea
While aria-label and aria-labelledby provide the name of an element (what it is), aria-describedby points to additional information that explains how to use it, what format is expected, or what will happen when you interact with it.
Think of it like this: if aria-labelledby is the title of a book, aria-describedby is the subtitle and description on the back cover—extra details that help you understand what you're dealing with.
How It Works
aria-describedby accepts one or more IDs (space-separated) that reference other elements containing descriptive text:
<label for="password">Password</label>
<input
type="password"
id="password"
aria-describedby="password-hint"
>
<p id="password-hint">
Must be at least 8 characters with one number and one symbol.
</p>
When a screen reader focuses the password input, it announces: "Password, edit text, Must be at least 8 characters..."
Common Use Cases
Form field instructions:
<input
type="email"
aria-describedby="email-format"
>
<small id="email-format">We'll never share your email.</small>
Button consequences:
<button aria-describedby="delete-warning">
Delete Account
</button>
<span id="delete-warning" hidden>
This action cannot be undone.
</span>
Multiple descriptions:
<input
type="text"
aria-describedby="char-count error-msg"
>
Notice the hidden attribute in the button example—the referenced element doesn't need to be visible; screen readers will still announce it.
Key Takeaway: Use aria-describedby to connect form fields, buttons, and interactive elements with helpful hints, formatting requirements, or warnings that assistive technologies should announce as supplementary information.