Course contentsShow
← Web Development
Lesson 1021 of 2,98218. Accessibility FundamentalsFree lesson

aria-describedby: Additional Context

Providing supplementary descriptions for form fields, buttons, and interactive elements.

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.