To make sure your table is accessible, you must have:
-
a descriptive header for every column
-
one header row only
-
only one item per row cell
-
no data or not applicable instead of empty cells
You should not have any split, merged or empty cells. The only time you should have an empty cell is the top left cell. This is used if you have a header row that does not need a column header. If youre copying and pasting a spreadsheet or a table from a document, remove any split or merged cells and fill in any empty cells.Empty cells make it difficult for users of assistive technology in particular to navigate the table.
Tables must always have a header row that includes a header explaining the content of each column in your table.
Headers help users understand the tables structure.
Table headers should:
You can use links in row and column headers.
If your table also has a row header, use the # header Markdown. The row headers must be in column one. In the example below, the 3 different types of fruit are row headers, and Alice and Ben are column headers.
| | Alice | Ben |
|--- |--- |--- |
|# Apples | 0 | 3 |
|# Bananas | 2 | 3 |
|# Pears | 0 | 0|
As shown below, both the first row and the first column are marked as headers. As the row headers do not need a column header, the first cell is empty.
| Alice | Ben |
Apples | 0 | 3 |
Bananas | 2 | 3 |
Pears | 0 | 0 |
In the example below, Total score is the column header for the row headers. In this example, the top left cell is not empty as the row headers need a column header.
| Total score | Grade | Description|
|---------|---------|---------|
|# 0-30 | Fail | Your performance is unsatisfactory |
|# 31-42 | Grade B | Youll stay on the approved driving instructors (ADI) register |
|# 43-51 | Grade A | You have shown a high standard of instruction and youll stay on the ADI register|
Total score | Grade | Description |
0-30 | Fail | Your performance is unsatisfactory |
31-42 | Grade B | Youll stay on the approved driving instructors (ADI) register |
43-51 | Grade A | You have shown a high standard of instruction and youll stay on the ADI register |
Watch how screen readers use headers to make table content accessible. You can find the transcript in the video description on YouTube.
How screen readers use headings to make table content accessible