Pattern

Readable data tables

Tables should preserve scanability without exploding the width of the page.

When to use

  • When direct comparison matters more than narrative flow
  • When the content has repeated structured fields

Avoid when

  • When the information would read better as bullets or cards
  • When a table is being used only because it feels more technical

Implementation notes

  • Use strong header contrast and row rhythm
  • Preserve horizontal readability while allowing overflow strategies where needed
  • Do not let a giant table redefine the whole page width

Recommended surface: surface