Writing & StyleStyle guide

Table Captions

A table caption or title helps identify what a table contains and can improve navigation in accessible documents. W3C specifically documents the HTML caption element, while Microsoft recommends a clear table purpose and a title or brief introduction when necessary.

Quick answer

Give a table a concise identifying caption or title when readers need context or must distinguish it from other tables; use the platform’s semantic caption feature when available.

Key details

Core Issuegiving a table an identifying caption or title that helps readers understand and navigate it
Phrase Roletable labeling and accessibility
Registerdocuments and web content

Important caveats

Accessibility Boundary

W3C notes that the HTML caption element can identify a table in a document and is useful when screen-reader users navigate among tables.

Platform Boundary

The exact caption mechanism differs between HTML, word processors, publishing systems, and house styles.

Title Boundary

Microsoft recommends making the purpose of a table clear and, when needed, including a table title or brief introduction.

Further guidance

Practical Application

Give a table a concise caption or title when readers need to identify its subject or distinguish it from other tables. Use the document or platform’s semantic caption mechanism when available instead of simulating a caption with unrelated body text.

Reader Check

Would the table still make sense if encountered through a cross-reference or assistive technology, and does the caption identify the table without repeating every header?

Worked Example

Example caption: “Table 2. Response time by support tier.” The caption names the comparison; the column headers carry the detailed labels.

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. Tables Tutorial (opens in a new tab)W3C Web Accessibility Initiative · Accessible table header/data relationships and caption context
  2. Tables — Microsoft Style Guide (opens in a new tab)Microsoft Style Guide · House-style guidance on when structured data belongs in a table instead of a simple list

Explore the topic