- Article
- 2 minutes read
- Reviewed August 4, 2026
A data table represents relationships between rows and columns.
Correct structure allows screen readers to associate each data cell with its headers.
Tables should not be used for general page layout.
Use a Caption
A table caption identifies the subject of the table.
It is especially useful when several tables appear on the same page or when the purpose is not obvious from the preceding heading.
Header Cells
Use table header cells for row and column headings.
Simple tables can use the scope attribute to identify whether a header applies to a row or column.
More complex tables can require explicit relationships, but simplifying the table is often the better solution.
Keep Structure Simple
Avoid:
- Merged cells.
- Empty spacer rows.
- Several independent tables combined visually.
- Layout content inside data cells.
- Unclear abbreviations.
- Important meaning conveyed only through colour.
Split complex information into multiple tables or another format when that improves understanding.
Responsive Tables
Wide tables can create horizontal scrolling.
Options include:
- Allowing controlled horizontal scrolling.
- Reducing nonessential columns.
- Providing a summary view.
- Reformatting into lists or cards.
- Offering a downloadable accessible file.
Do not hide essential columns on small screens without another way to access them.
Gutenberg Table Block
The Table block can create simple tables and supports header and footer sections.
Verify the public markup, caption, header relationships and mobile behavior. Avoid inserting a table solely to align text or buttons.
Complex Data
Charts and tables can complement each other.
Provide the important conclusion in text and ensure the underlying data is available in an accessible format.
Frequently Asked Questions
Can a table be used to create columns?
No. Use layout blocks and CSS.
Does every table need a caption?
A caption is useful in most data-table contexts, especially when the topic is not otherwise explicit.
Continue Learning
Previous: [Accessible WordPress Forms](/resources/wordpress-manual/accessibility/accessible-wordpress-forms/)
Next: [Captions and Transcripts for Media](/resources/wordpress-manual/accessibility/captions-transcripts-media/)