Bridget is a blind mother to a five-year-old girl and an 11-year-old boy. She has a college-level education and works as a receptionist. When she uses a computer, she relies entirely on screen reader software to have websites read aloud or to access content through her braille display.
"Sometimes people send me links to pages with loads of customer info in big tables, and honestly, it can be a headache. If the table is complicated, my screen reader just goes row by row, cell by cell, and I have to piece everything together in my head. It takes time. But if there is just a little heads-up before the table; like what it is about and how it is laid out. then I’ve got a roadmap. I know what I am listening for, and I can get through it way faster without getting lost."
This section provides some examples of the issue.
The following table uses the exact same text for both the <caption> and the summary attribute, which is incorrect. While both elements serve an explanatory function, they are intended for different audiences and technologies.
<table summary="Monthly sales data for 2025.">
<caption>Monthly sales data for 2025.</caption>
Screen reader users may experience redundant information when the same content is provided in both places. The caption is visible to all users and gives a title to the table, while the summary is hidden and used specifically by assistive technologies to explain how the table is structured or how to navigate it.
In the example below, the caption gives a visible title to the table for all users, while the summary provides screen reader users with extra context on how the table is organized. This helps users of assistive technologies better understand and navigate the table.
<table summary="The table has three columns and lists monthly sales figures for Q1 2025. Each row represents one month.">
<caption>Monthly sales figures – Q1 2025</caption>
The caption briefly describes the content of the table, while the summary explains the structure. This ensures that users who rely on screen readers receive helpful information about how to interpret the data layout, without unnecessary repetition.
This section provides instructions on how to identify and fix this type of error.
The Acquia Web Governance platform identifies tables where both the summary and caption attributes contain the same text. These are considered failures and need to be fixed.
To fix this type of error, update the HTML code of the table so that both the caption and summary are used as intended. The caption should serve as a short, descriptive heading or explanation of the table’s content, and it is visible to all users. The summary is typically only available to users of assistive technologies, such as screen readers, and should be used to describe the structure of the table. For example, how the data is organized, how many rows or columns it has, or any other information that helps non-visual users understand how to interpret the table.
This section contains useful resources for this subject.
If this content did not answer your questions, try searching or contacting our support team for further assistance.
If this content did not answer your questions, try searching or contacting our support team for further assistance.