Custom Tooltips and Chart Markers
Custom Tooltips and Chart Markers
A chart has two layers of information: what you see, and what you get when you look closer. The visible layer should stay ruthlessly simple. The tooltip is where all the detail you didn't want cluttering the canvas gets to live.
Most dashboards ship with whatever the default tooltip happens to be. Ten minutes of configuration turns it into the most information-dense part of the whole page.
Choosing what appears on hover
Open a chart's properties and find the Tooltip section. You get direct control over the contents:
Dimensions
Which grouping values to show. Usually the one the user is hovering, but you can include others the step returns.
Measures
Which numbers to display. Show the plotted measure plus supporting ones the chart itself doesn't have room for.
Custom text
Free text you write, which can interpolate values from the step so it reads as a real sentence.
The key move is hiding the defaults you don't need. A tooltip repeating the axis label the user is already pointing at wastes a line. Switch off everything that isn't earning its place, and what remains reads as a deliberate message rather than a data dump.
Custom text that interpolates step fields
This is the part worth learning properly. The custom text box isn't static — you can reference fields from the step, and the tooltip substitutes the actual value for the hovered data point.
That means instead of a bare stack of label/value pairs, you can write a sentence:
closed across deals this quarter.
Hover a bar and you get a readable statement about that specific bar. It costs a couple of minutes and it changes how non-analysts experience the chart — they're reading a fact, not decoding a data structure.
- 1
Open the chart's tooltip settings
Select the widget and scroll the properties panel to the Tooltip section.
- 2
Turn off the noise
Uncheck the default dimensions and measures you don't want repeated on hover.
- 3
Enable custom text
Switch on the custom text option to reveal the editable text area.
- 4
Write the sentence and insert fields
Type your wording and drop in step field references where the live values should appear.
- 5
Hover and check
Test on several data points — including an empty or zero one — to make sure the sentence still reads correctly.
There's also a show null values option. Turn it on when a missing value is itself meaningful ("no activity logged"), and off when blanks are just noise that make the tooltip look broken.
Tooltips as inline help
Here's a use most people miss: a tooltip doesn't have to describe the data at all. It can explain the chart.
Dashboards accumulate metrics whose definitions live in somebody's head. Pipeline coverage, weighted forecast, adjusted attainment — every org has three of them and no two people define them the same way. Put that definition in the custom tooltip text and the answer sits exactly where the question gets asked: on the chart, at the moment of confusion.
Keep it short, though. A tooltip is a glance, not a page. If your explanation needs three paragraphs, it belongs in a text widget or a linked page — and it's probably a sign the metric itself needs simplifying.
Chart markers
Tooltips are on-demand. Sometimes you need the opposite: something permanently visible, attached to one specific point on the chart, that says "look here".
That's a chart marker — an annotation you pin to an individual bar, column, or data point. In the chart's properties you choose the point to mark and then configure three things:
Label
A short title on the marker itself — a few words at most, since it sits on top of the chart.
Message
The longer explanation of why this point deserves attention.
Colour
Set it to match the meaning — alert red for a problem, brand colour for a milestone.
Markers are for the story behind the number, the thing the data can't tell you itself:
- The month revenue dipped because a major account churned — mark it, so nobody re-investigates it every quarter.
- The quarter you changed the methodology, so the reader knows a step-change isn't a real trend.
- The record-breaking week worth calling out rather than leaving to be noticed.
Used sparingly — one or two per dashboard — markers are the closest thing CRM Analytics has to a footnote, and they stop the same question being asked every month.
Your charts now explain themselves. Next we shrink them right down and build the row of indicators that sits at the top of every good dashboard: KPI micro charts.
Discussion
No comments yet — be the first to start the discussion.