Aria-describedby
The aria-describedby attribute associates an interface element with one or more elements that provide supplementary descriptive text.
Tiny CSS Projects
The aria-describedby attribute identifies elements that provide additional descriptive information for an interface element.
- How it is used
- Connects form controls to additional error information for screen readers and assistive technologies.
- How deep it goes
- Explains the ID relationship and the consequence of hiding the referenced element, but stops short of broader ARIA guidance.
- Examples
- Uses a required name input, a nameError container, and a role="alert" span for conditional validation feedback.
- What you can do after
- Apply it to preserve an accessible connection between a form field and its error message while hiding feedback conditionally.
Architecting Accessibility
aria-describedby is an ARIA attribute that associates an interface element with one or more elements providing supplementary descriptive text.
- How it is used
- Associates supplementary hints, constraints, formatting guidance, or warnings with controls without folding them into the visible label.
- How deep it goes
- Shows when to reference supplementary text and provides form examples, but does not detail announcement mechanics.
- Examples
- Uses form hints and inline errors for an owner-name field, plus a warning on a clear-all button.
- What you can do after
- Apply it via aria-describedby to associate visible hints, errors, or warnings with controls.
Read how Architecting Accessibility explains aria-describedby →
Also covered in
- Vanilla WebIn early access (MEAP)
What to know first
- JavaScriptJavaScript is a high-level, dynamically typed programming language standardized as ECMAScript and used for web and general-purpose programming.
Related concepts
- accessible descriptionuses · Supplementary programmatically associated text that provides instructions, examples, or constraints for an interface control.
- web formused by · A web form is a web-page interface that groups controls for collecting user input and submitting it for processing.
- live regionused by · A live region is an accessibility-designated area whose dynamically changing content can be announced by assistive technologies.
- screen readeruses · A screen reader is assistive software that presents digital content and interface information through synthesized speech or refreshable braille.
- tooltipused by · A tooltip is a transient interface label that displays brief contextual information near an associated element during interaction.
Questions about aria-describedby
What is aria-describedby?
The aria-describedby attribute associates an interface element with one or more elements that provide supplementary descriptive text.
Which Manning books explain aria-describedby?
Tiny CSS Projects and Architecting Accessibility.
What should I know before learning aria-describedby?
Manning books that teach aria-describedby usually introduce JavaScript first.
What is aria-describedby a kind of?
Aria-describedby is a kind of ARIA property. An ARIA property is an accessibility attribute that describes an element’s characteristics, relationships, or additional information.
These guides are generated from the text of Manning books by Manning's knowledge graph and link to the sections they draw on. The full books are available on liveBook and at manning.com.

