Guidelines
Suggest edit

Use a table for structured record lookup

For retrieve tasks on structured record lists, use a table instead of text to improve lookup speed and mitigate missed reader-relevant details for readers seeking the entry that applies to them.

  • purpose:select
  • basis:heuristic
  • task:retrieve
  • chart:table:use
  • chart:text:avoid
  • quality:readability
  • lever:chart-family
  • reading-mode:lookup

advice

Record lookup

Use a table when readers need to find the entry that applies to them. For example, move structured items such as locations, ages, income ranges, names, teams, or states out of a text block and into rows and columns.

reason

Why table lookup works

A table helps readers jump to the row they care about instead of reading a paragraph from start to finish.

Mechanism: Tables support lookup because readers can scan for their own record, while prose forces sequential reading and makes specific facts slower to find.

Evidence: The post recommends tables when readers need to look up specific information and says people will often search only for the data that applies to them, which can be faster in a table than in text (Muth, 2019).

context

Use when readers need one record

  • User Goal: Find the entry that applies to the reader.
  • Task: Lookup of a specific value or record.
  • Data: Structured text-like records such as names, places, teams, or ranges.
  • Chart Setting: Information is currently embedded in prose or another narrative block.
  • Success Criterion: A reader can find their own row quickly without reading everything.

exceptions

Do not use for pattern-first reading

Break it when: The main goal is to show an overall pattern, outlier, biggest value, or smallest value. Why: The post says tables are read sequentially, while charts make overall patterns and extremes easier to notice.

costs

Tradeoffs of replacing text with a table

Sacrifice: You give up some narrative flow from continuous prose.
Risk: Important values can hide lower in the table because readers may not read the whole thing.
Mitigation: Switch to a chart when the job is overview rather than lookup.

mistakes

Common prose-to-table failure

Mistake: Leaving repeated structured facts inside a paragraph. Why it fails: Readers must scan prose instead of jumping to the row that matches them.

check

Check whether lookup beats prose

Failure Sign: The same kinds of facts repeat in prose and readers would likely search for just one of them.
Quick Check: Compare a paragraph version with a simple table and see which one lets a reviewer find one target item faster.
Stronger Test: Ask whether most readers need only the row for their own location, team, age, or range rather than the full narrative.

fix

Fix the lookup structure

  • Turn repeated items into rows and shared attributes into columns.
  • Put the lookup key where readers can scan for it directly.
  • Replace the prose block with a table when the story asks readers to find their own entry.

References

Muth, L. C. (2019). What to consider when creating tables. https://www.datawrapper.de/blog/guide-what-to-consider-when-creating-tables