Explain every data-carrying color with a color key
For charts where color encodes values or variables, use explicit color keys on the chart to improve readability and mitigate ambiguous color meaning for readers.
- purpose:refine
- basis:heuristic
- quality:readability
- lever:text-annotation
- component:legend:use
- aesthetic:color:use
advice
Color key
Add a color key whenever color represents data rather than only making marks visible. For example, state what each category hue stands for or show what the low and high ends of a color gradient represent.
reason
Why color keys are necessary
A reader cannot decode a color encoding reliably if the chart never states what the colors mean.
Mechanism: A color key turns hue or lightness from decoration into an interpretable variable mapping.
Evidence: The post says that every visual mark representing a value or variable should be explained and that the same is true for colors, then recommends adding a color key to tell readers what the colors encode (Muth, 2018).
context
When to add a color key
- User Goal: Interpret what a color encoding means.
- Data: Color carries category or value information.
- Chart Setting: The chart uses multiple hues or a gradient as a data encoding.
- Success Criterion: Readers can tell what each data-carrying color means from the chart itself.
exceptions
When a color key is unnecessary
Break it when: Color only makes marks visible and does not encode a value or variable. Why: The rule applies to colors that carry data meaning.
costs
Tradeoffs of adding a color key
Sacrifice: The chart uses more space for explanatory labeling. Risk: A vague or incomplete key still leaves colors ambiguous. Mitigation: Name every data-carrying hue or gradient endpoint explicitly.
mistakes
Common color-key mistake
Mistake: Leaving a data-carrying color unexplained. Why it fails: Readers cannot know whether the color signals a category, a value range, or nothing important.
check
How to check color explanation
Failure Sign: At least one plotted color has no stated meaning. Quick Check: Point to each data-carrying color and ask what it encodes. Stronger Test: Verify that both category hues and gradient ranges are explained in the chart.
fix
How to fix missing color explanation
- Add a key that maps each category hue to its category.
- Add a key that labels the ends of a value gradient.
- Ensure every color that represents data is named in the chart’s key.