Guidelines
Suggest edit

Repeat the chart subject and measure inside the chart

For first-pass reading, use redundant on-chart wording across annotations and axes on charts to improve readability and mitigate reliance on a single title or description for readers who may skip it.

  • purpose:refine
  • basis:heuristic
  • quality:readability
  • lever:text-annotation
  • component:annotation:use
  • component:axis:use
  • communication:framing

advice

Repeat what the chart shows

Repeat the subject and measured quantity inside the chart instead of relying on one title or description. For example, mention the topic in multiple annotations, name the axis with the quantity and unit, and vary the wording with synonyms so different readers still recognize the concept.

reason

Why redundant on-chart wording works

Many readers dive into a chart before they read its description. Repeating the subject and measure inside the chart pushes key context toward them while they browse, instead of forcing them to stop and look for plan-B text.

Mechanism: Redundant wording across annotations and axes makes the chart self-explanatory during normal browsing and helps more readers recognize the concept and the measure without extra decoding.

Evidence: The post says readers often treat the chart description as a fallback and praises a chart that repeats the topic term several times in the chart itself, reinforces the measured quantity with axis text and units, and uses different phrases for the same concept so more readers can understand it (Muth, 2017).

Notes: Different supported phrases can help readers with different vocabularies, including readers who know one term for the concept but not another.

context

Use when readers may skip the chart description

  • User Goal: Let readers understand what the chart is about without consulting a separate description.
  • Chart Setting: The chart includes axes or annotation text, and readers may enter it before reading the chart description.
  • Audience: Readers with mixed vocabulary familiarity, including readers who may know one term for the concept but not another.
  • Success Criterion: Readers can tell both the topic and the measured quantity while browsing the chart itself.

exceptions

Do not use when repeated text cannot survive the layout

Break it when: The chart must shrink to a very small mobile layout and the repeated on-chart text cannot remain visible. Why: The source notes that many annotations disappear in the smaller mobile version of the chart.

costs

Tradeoffs of redundant on-chart wording

Sacrifice: Space inside the chart for additional text.
Risk: Redundant wording takes more writing and editing effort.
Mitigation: Spread the repetition across existing components such as annotations and axis labels, and use short synonyms.

mistakes

Common failure mode: relying on one description

Mistake: Putting the subject and measured quantity only in the chart title or description. Why it fails: Many readers do not read that text until they are already confused.

check

Check whether the chart explains itself without the description

Failure Sign: If you ignore the title or description, the chart’s topic or measure becomes unclear.
Quick Check: Cover the description and see whether the chart still names the topic and the unit inside the plot area or axes.
Stronger Test: Count whether the core concept appears in more than one on-chart place.

fix

Fix the chart by repeating the subject and measure on-chart

  • Add the topic term to multiple annotations inside the chart.
  • Add the measured quantity and unit to the axis text.
  • Replace one repeated term with a supported synonym if a different phrase may be more familiar to some readers.
  • Do not leave the title or description as the only place that names the topic.

References

Muth, L. C. (2017). Respect your readers’ time. https://www.datawrapper.de/blog/readers-time