Create tooltips based on report pages

APPLIES TO: Power BI Desktop Power BI service

You can create visually rich report tooltips that appear when you hover over visuals, based on report pages you create in Power BI Desktop and the Power BI service. By creating a report page that serves as your tooltip, your custom tooltips can include visuals, images, and any other collection of items you create in the report page.

Just getting started modifying tooltips? Check out Customize tooltips.

Screenshot of report tooltips for Power BI.

You can create as many tooltip pages as you want. Each tooltip page can be associated with one or more fields in your report, so that when you hover over a visual that includes the selected field, the tooltip you created on your tooltip page appears when you hover over the visual, filtered by the datapoint over which your mouse is hovering.

There are all sorts of interesting things you can do with report tooltips. Let's take a look at how to create tooltips and what you must do to configure them.


You may be interested in trying the new visual tooltips, currently in preview. They can include drill-down and drillthrough actions, and can reflect report theme styling. Read more about visual tooltips.

Create a report tooltip page

To get started, create a new report page by clicking the + button, found along the bottom of the Power BI Desktop canvas, in the page tabs area. The button is located beside the last page in the report.

Screenshot shows how to create a new report page for the tooltip.

Your tooltip can be any size, but keep in mind that tooltips hover over the report canvas, so you might want to keep them reasonably small. In the Format pane in the Canvas Settings card, you can see a new page size template called Tooltip. This provides a report page canvas size that's ready for your tooltip.

Screenshot of report page size canvas for a ready-made tooltip.

By default, Power BI Desktop fits your report canvas to the available space on the page. Often that's good, but not in the case of tooltips. To get a better sense and view of what your tooltip will look like when you're done, you can change the Page View to actual size.

To see the actual size of the tooltip, select the View tab from the ribbon. From there, select Page View > Actual Size, as shown in the following image.

Screenshot of page view drop down to show actual size for easier tooltip creation.

You can also name the report page so its purpose is clear. Just select the Page Information card in the Format pane, then type the name into the Name field you find there. In the following image the tooltip report name is Tooltip 1, but feel free to name yours something more inspired.

Screenshot of Name your tooltip report page.

From there, you can create whatever visuals you would like to show up in your tooltip. In the following image, there are two cards and one clustered bar chart on the tooltip page, along with a background color for the page itself, and backgrounds for each of the visuals, to give it the look we wanted.

Screenshot shows a customized report tooltip.

There are more steps to complete before your tooltip report page is ready to work as a tooltip. You need to configure the tooltip page in a few ways, as described in the next section.

Configure your tooltip report page

Once you have the tooltip report page created, you need to configure the page in order to register it as a tooltip, and to ensure it appears in over the right visuals.

To begin with, you need to turn the Tooltip slider to On, in the Page Information card, to make the page a tooltip.

Screenshot of tooltip slider to indicate the page is a tooltip.

Once that slider is set to on, you specify the fields for which you want the report tooltip to appear. For visuals in the report that include the field you specify, the tooltip will appear. You specify which field or fields apply by dragging them into the Tooltip fields bucket, found in the Fields section of the Visualizations pane. In the following image, the Total Defect Qty field has been dragged into the Tooltips fields bucket.

Screenshot of fields to determine where the tooltip will appear.

You can include both categorical and numerical fields in the Tooltips fields bucket, including measures.

Once completed, the tooltip report page you created will be used as a tooltip in visuals in the report that use any fields you placed into the Tooltips fields bucket, replacing the default Power BI tooltip.

Manually setting a report tooltip

In addition to creating a tooltip that automatically appears when hovering over a visual that contains the specified field, you can manually set a tooltip.

Any visual that supports report tooltips now has a Tooltip card in its Formatting pane.

To set a tooltip manually, select the visual for which you want to specify the manual tooltip, then in the Visualizations pane, select the Format section and expand the Tooltips card.

Screenshot of tooltip card for an individual visual.

Then, in the Page dropdown, select the tooltip page you want to use for the selected visual. Note that only report pages that are specified as Tooltip pages show up in the dialog.

Screenshot of tooltip page selection for manual tooltip.

Being able to manually set a tooltip has many uses. You can set a blank page for a tooltip, and thereby override the default Power BI tooltip selection. Another use is when you don't want the tooltip that is automatically selected by Power BI to be the tooltip. For example, if you have a visual that includes two fields, and both of those fields have an associated tooltip, Power BI selects only one to show. You might not want that to be the case, so you could manually select which tooltip should be displayed.

Reverting to default tooltips

If you create a manual tooltip for a visual but decide you want the default tooltip instead, you can always return to the default tooltip that Power BI provides. To do so, when a visual is selected and the Tooltips card is expanded, just select Auto from the Page dropdown to go back to the default.

Screenshot shows how to select default tooltip for a visual.

Custom report tooltips and line charts

There are a few considerations to keep in mind when your report tooltips are interacting with line chart visuals, and with visuals when cross-highlighting.

Report tooltips and line charts

When a report tooltip is displayed for a line chart, only one tooltip for all lines in the chart is displayed. This is similar to the default tooltip behavior for line charts, which also displays only one tooltip.

This is because the field in the legend does not get passed through as a filter for the tooltip. In the following image, the tooltip being displayed is showing all units sold on that day across all three classes displayed in the report tooltip (in this example, Deluxe, Economy, and Regular).

Screenshot of line charts that show aggregated tooltip data.

Report tooltips and cross-highlighting

When a visual is being cross-highlighted in a report, report tooltips always show the cross-highlighted data, even if you're hovering over the faded section of the data point. In the following image, the mouse is hovering over the faded section of the bar graph (the section that is not highlighted), but the report tooltip still shows data for the highlighted portion of that datapoint (the highlighted data).

Screenshot of report tooltips show highlighted data when cross-highlighting occurs.

Considerations and limitations

There are a few considerations and limitations for tooltips to keep in mind.

  • Button visuals also support tooltips.
  • Dashboards don't support page tooltips.
  • Python and R visuals are not currently supported to be shown in report tooltips.
  • Clusters are not currently supported as fields that can be shown in report tooltips.
  • When choosing a field to be shown for report tooltips, when using a field versus a category, visuals that contain that field will only show the specified tooltip when summarization with the selected field matches.
  • You can turn tooltips off completely for a visual in Power BI reports. However, when you pin that visual to a dashboard in the Power BI service, the basic tooltip will still be displayed.

For more information about features that are similar or interact with report tooltips, take a look at the following articles: