Table

Tables allow users to review large amounts of sequential information at a glance.

Table
Best practices

Tables are useful for organising data in grids and can be used to: Compare data points, Find insights, Find specific information within a large data set, and Show long lists of sequential or structured content.

  • Keep cell content short and succinct
  • Don’t write long form content inside of table cells

Short content on table

Keep cell content short and succinct

Table with long text

Don’t write long form content inside of table cells

When to use

Use tables when you need to display comparison information across columns and rows.

  • Don’t put a table inside of another table
  • Don’t use tables for minimal information where you can use a list item component instead
  • Avoid using detailed tables in small spaces like modals or drawers

Table in modal

Avoid using detailed tables in small spaces like modals or drawers

Table with simple content

Don’t use tables for minimal information where you can use a list item component instead

Interaction

Users can perform a single action across a row.

Full with interaction on table row
Single action
Device

The table component is a mobile responsive web component — at smaller screen widths it activates a horizontal scroll, so that the user can still scan all information.

Full width table

Full width on desktop

Table responsive truncated width

Responsive width with horizontal scroll

Cell types

Table has 5 different cell types used for different types of information — header, leading, text, currency and status.

Header cell example
Leading cell example
Leading
Text cell type example
Text
Currency cell type example
Currency
Status cell type example
Status

Leading

The leading cell is used for your first table cell to lead the rest of the content.

While your leading cell should be used as your first cell type, depending on your use case you can use different cell types as your leading cell.

Leading supports default, error and success states.

Default example of leading cell type
Default
Error on leading cell type
Error
Success on leading cell type
Success

Text

The content cell is used for text based information.

Content supports default, error and success states.

Default text cell type example
Default
Error text cell type example
Error
Success on text cell type example
Success

Currency

The currency cell is used for displaying currency and currency flags.

This cell is always right aligned to conform to numerical display standards in tables.

Currency supports default, error and success states.

Default currency cell type example
Default
Error on currency cell type example
Error
Success on currency cell type example
Success

Status

The status cell is used for indicating the status of a row.

Status supports info, pending, warning, error and success states.

Info status cell type example
Info
Pending status cell type example
Pending
Alert status cell type example
Alert
Error status cell type example
Error
Success status cell type example
Success
Availability