Writing & StyleStyle guide

Writing Extended Accessible Descriptions

Writing Extended Accessible Descriptions records a distinct W3C-supported accessibility writing task while keeping implementation mechanics outside the writing guidance.

Quick answer

Use a structured extended description when the explanation is too detailed or structurally rich to work well as one short description string.

Key details

Core IssueWAI-ARIA 1.2 provides aria-details for detailed or structured descriptive content when flattening that information into a short description string would lose useful structure.
Registerweb accessibility and interface content

Important caveats

Scope Boundary

Use a short accessible description for concise supplemental text; reserve extended structured content for cases where detail or structure is materially useful.

Further guidance

Content

For an extended description, organize the content so headings, lists, links, tables, or other meaningful structure remain understandable in their own right.

Purpose

Structured extended descriptions let users navigate detailed explanatory material instead of receiving one long flattened string.

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. WAI-ARIA 1.2 (opens in a new tab)World Wide Web Consortium (W3C) · WAI-ARIA 1.2 support for accessible descriptions and structured extended descriptions including aria-details.

Explore the topic