Official website

of the Commonwealth of Pennsylvania

Components

Table

Tables display data in a structured grid. They’re made up of rows and columns.

Overview

A table is a simple grid that displays data in a structured format. Tables can use numbers, short sentences, phrases, or other data points.

Tables can help the user find specific information. They can also be useful when comparing information. For example, a table with office addresses and hours can help a user choose the best location for them.

Usage

When to use

Use a table to:
  • Display data simply.
  • Compare content across columns and rows.
  • Structure short bits of content to be visually scannable.
If you have a large data set, consider using multiple tables with clear headings.

When not to use

  • Avoid tables if you have cells with long written sections. If your table includes paragraph-length information, consider another format.
  • Do not use tables to create layouts for web pages. For more information on layouts in KDS, visit our layout grid documentation.

Accessibility

  • A table needs a clear header that gives the user enough context to understand the contents.
  • Use brief, clear labels for the columns and rows. Follow plain language best practices

Related documentation

We want to hear from you

This is a pre-release version of Keystone Design System. If you're a beta tester, we want your bug reports, questions, and feedback.

 

Complete our form to share your thoughts—just log in with your PA.gov email. We'll review and consider every response.