Tableau Viz in Tooltip: Contextual Detail Without Leaving the View

Viz in Tooltip is a Tableau feature that embeds a fully interactive Tableau view inside the tooltip that appears when a user hovers over a mark. Rather than showing static text and field values in a tooltip, Viz in Tooltip renders a secondary chart that responds to the context of the mark being hovered. It is one of the most effective mechanisms for providing analytical depth without cluttering the main dashboard — contextual detail appears on demand, exactly when the user needs it, and disappears when they move on.

What Viz in Tooltip Enables

The core value proposition of Viz in Tooltip is contextual detail without navigation. Without it, providing detail for a mark on a dashboard requires either:

- Adding a secondary chart to the dashboard that shows detail for the selected item, consuming permanent screen real estate and adding visual complexity even for users who do not need the detail

- Requiring the user to navigate to a separate sheet or dashboard, breaking their analytical flow

Viz in Tooltip delivers the secondary chart on hover, taking up no dashboard space when not in use and appearing exactly when the user's cursor indicates interest.

Common Viz in Tooltip applications:

**Trend context** — hovering over a period's bar in a bar chart shows the trend line for that period's metric over the past 12 months. The user gets the full trend without a persistent line chart on the dashboard.

**Distribution** — hovering over an aggregate metric in a KPI tile shows the distribution of individual values underlying the aggregate. The user sees whether the average they are looking at reflects a tight distribution or a wide spread.

**Geographic drill-down** — hovering over a region in a map shows a bar chart breakdown of that region by city or district.

**Ranking context** — hovering over a customer in a table shows where that customer ranks on multiple dimensions compared to the full customer population.

Building a Viz in Tooltip

Viz in Tooltip is configured through the tooltip editor of the source sheet:

1. Create the tooltip sheet — a separate sheet in the workbook that contains the chart to be shown in the tooltip. This sheet should be designed for the tooltip dimensions: typically 300px wide by 200px tall, with minimal axes and labels, and a dark or white background that contrasts with the dashboard.

2. Open the tooltip editor on the source sheet (Worksheet > Tooltip, or the Tooltip shelf in the marks card).

3. Click "Insert" and select "Sheets" to insert the tooltip sheet reference. The syntax is:

Sheet name=tooltip_chart_name maxwidth=300 maxheight=200 filter="Dimension Name"

4. The filter attribute tells Tableau which field in the tooltip chart to filter based on the hovered mark. If you are hovering over a customer mark in the source sheet, the filter should be the customer dimension so the tooltip chart shows data for the hovered customer only.

Tooltip Sheet Design

The tooltip sheet requires careful design for the confined space:

**Keep it minimal** — tooltip charts are small. One or two marks per axis, no legends, abbreviated axis labels. The tooltip context (which customer, region, or period is being hovered) comes from the source mark; the tooltip chart only needs to show the detail.

**Match the analytical purpose** — the tooltip chart should answer exactly one analytical question that is natural when looking at the source mark. If the source chart shows revenue by customer, the tooltip might show revenue trend for that customer. It should not show an unrelated metric.

**Dark background or transparent background** — tooltip backgrounds that match the dashboard background or are dark enough to contrast with the default tooltip panel improve readability.

**Suppress headers and labels where possible** — axis titles, field labels, and measure names add noise in the tooltip context. Show values on marks (mark labels) rather than axis ticks where possible.

Filter Context in Viz in Tooltip

The filter attribute in the Viz in Tooltip configuration determines how the tooltip chart responds to the hovered mark. When a user hovers over a mark in the source sheet, the tooltip chart is filtered to show data for the dimension value(s) of that mark.

Multiple filters can be applied: if the source chart is cross-filtered by Region and Product, and both need to carry through to the tooltip, both can be specified as filter attributes.

One important constraint: the tooltip sheet and the source sheet must share the same data source, or the data sources must have compatible field names for the filter to resolve correctly. If the tooltip chart uses a different data source than the source sheet, the filter field must exist in both data sources with the same name.

Performance Considerations

Viz in Tooltip fires a query every time a user hovers over a mark. For source charts with many marks and tooltip charts querying large datasets, this can generate significant query volume. Optimisation approaches:

**Use extracts for the tooltip sheet's data source** — extract-backed tooltip charts respond much faster than live-connection tooltip charts.

**Pre-aggregate the tooltip sheet** — a tooltip chart showing a pre-aggregated time series (daily or monthly) is faster than one showing row-level data.

**Limit tooltip chart complexity** — a simple 12-point trend line query is far lighter than a 1000-row scatter plot query. Design tooltip charts to be simple enough to return quickly.

**Avoid tooltip sheets on high-density scatter plots** — a scatter plot with 50,000 marks will trigger tooltip queries on almost any mouse movement over the view. Consider whether Viz in Tooltip is appropriate for high-density source charts, or whether a filter action to a separate detail view is a better pattern.

Viz in Tooltip vs Detail Dashboards

The choice between Viz in Tooltip and a separate detail dashboard depends on the analytical workflow:

**Use Viz in Tooltip when** the detail is contextual and transient — the user glances at the trend and continues scanning. The detail does not need to persist, and the user is not likely to want to interact with the detail chart.

**Use a separate detail dashboard when** the user needs to interact with the detail (apply filters, drill down further), when the detail is complex enough to need full screen space, or when the user workflow involves dwelling on the detail for an extended period.

Many production dashboards use both patterns: Viz in Tooltip for quick contextual glances, and a navigation action (click to open detail dashboard) for users who want to explore further.

Our Tableau consulting practice designs analytically sophisticated Tableau dashboards including Viz in Tooltip implementations for enterprise clients — contact us to discuss dashboard design for your analytics environment.

A former Microsoft data architect audits your data foundation, identifies your top priorities, and sends you a written plan. Free. No pitch.