Guidelines
Suggest edit

Place labels next to the marks they explain

For quick lookup on color-coded charts, prefer nearby labels over separated legends to improve readability and mitigate repeated eye-travel for readers scanning the graphic.

  • purpose:refine
  • basis:heuristic
  • quality:readability
  • lever:text-annotation
  • component:label:use
  • component:legend:avoid

advice

Directly label the marks

Place labels or explanations beside the marks they describe instead of sending readers to a distant legend. For example, label line series on the lines themselves or move bar explanations next to the colored bars instead of keeping a color key in a corner.

reason

Why nearby labels work

Readers waste time when they have to shuttle their eyes between a mark and a far-away key. Nearby labels keep decoding local, so identification becomes faster and less frustrating.

Mechanism: Bringing the explanation to the mark removes repeated back-and-forth lookups, which reduces search effort and makes the chart easier to scan.

Evidence: The post explicitly warns against charts with a color key in one corner and the colored lines or bars elsewhere, and recommends bringing elements and their explanations as close together as possible, including labeling lines directly rather than relying on a separate legend (Muth, 2017).

context

Use when the chart requires mark-to-label lookup

  • User Goal: Identify what a colored line, bar, or other mark represents quickly.
  • Task: Lookup rather than prolonged exploration.
  • Chart Setting: The chart uses colored marks and would otherwise rely on a separate color key or legend.
  • Audience: Readers scanning the chart and asking what a given color represents.
  • Success Criterion: Readers can identify each highlighted element without looking to another corner of the chart.

exceptions

Do not use when small-screen space removes the labels

Break it when: The chart must collapse to a very small mobile view and on-mark labels cannot survive the reduced space. Why: The source notes that rich annotations often disappear in mobile-first versions of the same chart.

costs

Tradeoffs of direct labels

Sacrifice: Some layout flexibility and responsiveness.
Risk: Direct labels can disappear or become hard to preserve in very small views.
Mitigation: If small screens force fewer labels, use animation to communicate some of the same information.

mistakes

Common failure mode: separating the legend from the marks

Mistake: Keeping a distant legend or color key while the marks sit elsewhere in the chart. Why it fails: Readers have to look back and forth repeatedly to decode the display.

check

Check whether label lookup stays local

Failure Sign: To decode a mark, you look from the mark to a far-away key and back again.
Quick Check: Pick any colored element and see whether its explanation is visible in the same local area.
Stronger Test: Shrink the chart to a smaller view and see whether the nearby labels still survive; if they vanish, the chart needs a small-screen fallback.

fix

Fix the chart by moving labels onto the marks

  • Remove the separated legend when the marks can be labeled directly.
  • Put the series name or explanation on the line, bar, or immediately beside it.
  • Rework the layout so the explanation sits near the mark instead of in a distant corner.
  • If small screens cannot hold the direct labels, replace some of the lost explanation with animation.

References

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