Writing Accessible Grid Descriptions
Writing Accessible Grid Descriptions records a distinct W3C-supported interface-writing task while keeping implementation mechanics outside the writing guidance.
Use a grid description for concise additional context or instructions that users need after hearing the grid’s name; do not repeat the name or restate the data itself.
Key details
Important caveats
Scope Boundary
This page covers authoring grid-level descriptive text; keyboard interaction, cell labeling, and the aria-describedby implementation are separate concerns.
Further guidance
Content
Describe information that helps users understand the grid as a whole, such as its purpose or necessary interaction context, rather than repeating its name or cell contents.
Practical Application
Use a grid description only for short context or operating guidance that users need after hearing the grid name, such as what the rows represent or an interaction constraint; do not repeat the name or narrate the visible data.
Purpose
A focused grid description can supply context that is not practical to place in the short grid name.
Reader Check
Does the description add information that changes how a user understands or operates the grid, rather than duplicating its label or cells?
Worked Example
Example: Name the grid “Quarterly sales” and describe it as “Use arrow keys to move between regions and quarters” when that interaction guidance is needed.
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.
- Grid Pattern — WAI-ARIA Authoring Practices Guide (opens in a new tab)World Wide Web Consortium (W3C) · W3C APG guidance for accessible naming, context, captions, and descriptions of interactive grids.