Provide a caption on tables

Applicable Role(s): Content Creator, Developer


Assistive technologies will read the caption or accessible name of tables on your page, making it especially important to have unique names/captions for each table. Multiple tables on a page without captions will make it difficult for assistive technology to tell one table from another.

Best Practices

  • Make the caption brief. This should be like alt text for an image.
  • The caption must be the first element with a <table> element.

Pattern Examples

Unique name describing table contents
Table Header Title Header Category Date
Link Data Data Data Data


<caption>Unique name concisely describing 
table contents</caption> 

In Drupal:

Table properties dialog with caption field filled in