Annotations: Context where you need it

Annotations transform silent charts into guided tours through your data.

• Axis highlights spotlight important values or ranges on your scales, like marking thresholds, averages, or meaningful benchmarks
• In-story annotations place explanatory text right where insights emerge, calling out peaks, valleys, outliers, and turning points that demand attention.

Axis highlights

Axis highlights (or axis annotations) add reference lines, labels, and shaded regions directly onto your X or Y axes to emphasize meaningful values or ranges. They’re perfect for marking thresholds like “break-even points,” highlighting periods like “recession,” or simply drawing a bold line at zero to anchor your audience’s interpretation.

In-story annotations

In-story annotations provide targeted explanations directly within the visualization, helping viewers understand key events, patterns, or anomalies as they encounter them. By adding context at the point of interest (such as policy changes, seasonal effects, or data irregularities), annotations reduce ambiguity and make the narrative easier to follow.

Rather than leaving interpretation to the viewer, they guide attention to what matters and clarify why it matters, turning the chart into a more structured and informative experience.

Legends and direct labels: when to use each

Traditional legends make viewers look back and forth between the chart and the legend, which slows understanding. Direct labels solve that by placing names next to the data they represent, making it easier to conncet colors to categories at a glance.

Both approaches have their place – the right choice depends on the chart and how much clarity you can achieve without adding visual clutter.

Use direct labelling when possible

For line charts with a few series (3-7) or bar charts with categories, place labels directly on the chart – at the end of lines, on bars, or in the title. This removes the need for a separate legend and makes it easier to follow the data.

Combine both for complex visualizations

For dense or complex visualizations, use selective labels to highlight what matters most. In Flourish templates like scatter plots, you can choose specific points to label, such as top performers, outliers, or key examples – while leaving the rest unlabeled.

This keeps the chart readable while still guiding attention to the most important data. You can then use a legend or tooltip to provide context for the remaining points.

Add layered context with popups and panels

Popups and panels help you include more detail without cluttering the chart. Instead of adding extra labels or text, you can reveal information only when users interact with the data.

Use them to show exact values, breakdowns, definitions, or sources, keeping the main view clean while still providing depth for those who need it. This layered approach allows your visualization to work at different levels: easy to scan at first glance, with additional context available on demand.

Transparency on data and methodology

The footer of your visualization should document everything your audience needs to verify and contextualize your work – data sources with dates, methodology notes, key assumptions, data licensing information, and any caveats about collection or processing.

This level of transparency separates professional data storytelling from casual chart-making, demonstrating rigor and allowing others to reproduce, verify, or build upon your analysis. Think of your footer as the citations section of your visual story – it may be small text at the bottom, but it carries the weight of your credibility.