Writing & StyleStyle guide

Table Row Headers

Row headers identify what the rest of a row describes. Microsoft recommends placing row-identifying information in the leftmost column, and W3C accessibility guidance uses header markup and row/column relationships so assistive technology can preserve that context.

Quick answer

Use row headers when the first cell in each row identifies the data that follows, and mark the header relationship semantically in accessible formats such as HTML.

Key details

Core Issueidentifying the cells that label rows so data-cell relationships remain clear
Phrase Roletable structure and accessibility
Registerdocuments and web content

Important caveats

Accessibility Boundary

Visual emphasis alone is not enough for accessible HTML tables; header relationships should be programmatically identifiable.

Left Column Boundary

Microsoft recommends placing information that identifies a row in the leftmost column.

Structure Boundary

W3C distinguishes header cells from data cells and supports row headers through header markup and scope relationships.

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