Tableau tooltips display contextual information when users hover over marks in a visualization. Custom tooltips can include calculated fields, additional dimensions, and even embedded visualizations — making them one of the most effective tools for providing detail-on-demand without cluttering the main view.
A Tableau tooltip is the contextual information panel that appears when a user hovers over a mark — a bar, a point, a map shape, a text cell — in a Tableau visualization. By default, Tableau auto-generates a tooltip showing the fields used in the view. Custom tooltips replace or extend this with precisely the information that makes a visualization more useful: additional context, calculated fields not shown in the view, or embedded secondary visualizations that respond to the hover target.
Why Tooltips Matter
Tooltips are the primary mechanism for providing detail-on-demand without cluttering the main view. A bar chart showing revenue by region is clean at 10 regions — but what if analysts want to see the product mix, year-over-year change, and top customer contributing to each bar? Putting all that in the main view creates density that hides the primary message. The tooltip holds the detail, surfaced only when the user asks for it by hovering.
Effective tooltip design follows the same principle as effective dashboard design: show the most important thing clearly, and put supporting detail one interaction away. The tooltip is that one interaction.
Customizing Tooltip Content
Tooltip content is edited through the Tooltip shelf in the Marks card. The tooltip editor accepts text, field references, and formatting.
**Field references** insert current mark values: inserting [SUM(Sales)] shows the aggregated sales for the hovered mark. Field references update dynamically — hovering over different marks shows that mark's values.
**Calculated fields** can be referenced in tooltips even if they are not in the view. This is a common pattern: create a calculation for year-over-year growth, year-to-date total, or margin percentage, and reference it only in the tooltip. The main view stays clean; the tooltip provides the analytical context.
**Static text** in tooltips formats the display: label fields with context ("Revenue: $1.2M" instead of raw "1200000"), add units, explain what data is shown.
**Formatting** — bold, italic, font size, color — applies to tooltip text using the toolbar in the tooltip editor. Color can highlight key figures (red for negative growth, green for positive) to make the tooltip scannable.
Viz in Tooltip
Viz in Tooltip is one of Tableau's most powerful features: embedding a secondary visualization that appears in the tooltip. When hovering over a bar in a regional sales chart, the tooltip can show a mini-sparkline of monthly revenue trends for that region, or a breakdown of product categories, or a map of customers within that region.
To implement: in the tooltip editor, click the "Insert Sheet" button and select an existing worksheet. The sheet reference becomes a dynamic embedded visualization that filters to the context of the hovered mark — hovering over the West region filters the embedded sheet to West region automatically.
Considerations:
- **Performance:** Viz in Tooltip triggers a query when hovered. On live connections to large tables, this can introduce latency. Pre-computing the tooltip view's data or using extracts minimizes this.
- **Sheet design:** The embedded sheet should be designed for the small tooltip canvas (typically 300-400px wide). Remove titles, gridlines, and unnecessary context — the tooltip is compact.
- **Filter context:** The embedded sheet inherits the filter context of the hovered mark. Verify that the filter passes correctly, particularly when the main view has multiple dimensions on rows/columns.
- **Avoid overdoing it:** Viz in Tooltip is powerful but can confuse less technical users who don't know to hover. Use it for dashboards where the audience will explore, not for executive summaries where users scan quickly.
Tooltip Best Practices
**Show what the view cannot:** The main view communicates one message clearly. The tooltip extends that message with supporting context — trend, breakdown, comparison — that would clutter the view if always visible.
**Label clearly:** Raw field values without labels are ambiguous. "1,247,832" means nothing without context; "Revenue: $1.2M" is immediately clear. Use field labels and formatted values.
**Match precision to purpose:** Executives scanning dashboards don't need six decimal places. Use number formatting in tooltip field references to show the appropriate precision.
**Test hover behavior:** Verify that tooltips display correctly across all marks, including edge cases (marks with null values, marks at the extremes of filters, marks with small values that might render oddly).
**Disable tooltips when unhelpful:** Some visualizations — text tables showing all values, sparklines where every mark shows the same contextual data — gain nothing from tooltips. Disable the tooltip (uncheck Show Tooltips in the tooltip editor) to keep the visualization clean.
Tooltips and Accessibility
Screen readers do not read Tableau tooltips. For dashboards that require accessibility compliance, critical information in tooltips must also be accessible through the main view or through alternative navigation patterns. The Web Content Accessibility Guidelines (WCAG) requirement that information is not conveyed solely through hover applies to Tableau tooltips.
Tooltips in Tableau Server and Cloud
Tooltip behavior is consistent between Tableau Desktop, Server, and Cloud. Viz in Tooltip renders in browser on Server and Cloud with the same performance characteristics as Desktop (live connection queries execute on hover). For Tableau Pulse and Tableau Public, viz in tooltip support varies — verify for the specific deployment.
Our Tableau consulting services covers dashboard design, tooltip optimization, and performance tuning across Tableau Desktop, Server, and Cloud. Contact us to discuss your Tableau implementation.
A former Microsoft data architect audits your data foundation, identifies your top priorities, and sends you a written plan. Free. No pitch.
Book a Call →