Writing & StyleStyle guide

Writing Accessible Grid Descriptions

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

Quick answer

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

Core IssueW3C APG explicitly supports associating a grid with a caption or description via aria-describedby when descriptive context is needed.
Registerweb accessibility and interface content

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.

Purpose

A focused grid description can supply context that is not practical to place in the short grid name.

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. 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.

Explore the topic