Describe the encoded measure directly in the color key
For explanatory reading of a color-encoded chart, use direct measure labels in the color key to improve readability and mitigate extra abstraction for readers interpreting the scale.
- purpose:refine
- basis:heuristic
- quality:readability
- lever:text-annotation
- component:legend:use
advice
Legend as direct measure
Name the measured variable in the color key instead of a proxy rating. For example, replace star categories with value ranges and include the unit or threshold that the colors actually encode.
reason
Why direct legend labels work
A direct legend lets readers decode the colors in one step. A proxy scale adds a second decoding task before readers can interpret the mapped values.
Mechanism: Removing an extra abstraction layer makes the legend match the encoded data more closely, so readers can move from color to meaning without translating through a separate rating system.
Evidence: The post recommends cutting the star rating system from the color key and explaining the forecast measure directly there because it is one less layer of abstraction for readers to deal with (Mintzer-Sweeney, 2024).
context
Use when the legend currently uses a proxy scale
- User Goal: Help readers understand what the color scale means without extra decoding.
- Data: Quantitative values are grouped into color ranges.
- Chart Setting: The chart uses a color key, and the key currently relies on shorthand or a derived rating system.
- Success Criterion: A reader can identify the encoded variable and each range from the color key alone.
exceptions
Do not use when the key already states the measure directly
Break it when: The color key already names the encoded variable directly rather than through a separate rating system. Why: This recommendation targets the added abstraction created by proxy labels.
costs
Tradeoffs of direct measure labels
Sacrifice: You lose the compactness of a short rating shorthand.
Risk: The legend can become wordy if every bin label is long.
Mitigation: Use concise value ranges that still name the actual measure.
mistakes
Common legend failure
Mistake: Put proxy categories in the color key and explain the actual variable somewhere else. Why it fails: Readers must translate the proxy before they can read the colors.
check
Check whether the legend explains the data directly
Failure Sign: A reviewer needs the title or footnote to know what the colors encode.
Quick Check: Read the color key alone and ask whether it states the variable and the ranges directly.
Stronger Test: If a reviewer can repeat the rating labels but not the actual measure, the key is still too abstract.
fix
Fix the color key
- Replace proxy labels with direct value ranges.
- Add the encoded variable and its unit or threshold to the color key.
- Remove the extra rating system from the legend.