Power BI Custom Visuals: Integration Guide

This is about adding new visualizations, and let’s see how.

It's easy to download and use a custom visual in your reports.

1. Go to http://visuals.powerbi.com.

2. On the Welcome to Power BI custom visuals page, browse through the gallery and select a visual tile to see more information about that visual and, optionally, to download the visual.

3. On the tile page, read through the description and choose Download Visual.

4. On the This visual is published and is licensed to you by a Power BI community member? ... page, read the visual agreement. For tips on evaluating custom visuals, see Review custom visuals for security and privacy. When you select I Agree, the custom visual is downloaded to your computer.

5. Save the .pbiviz file.

6. To use a custom visual, see Add a custom visual to a report (Service) or Add a custom visual to a report (Desktop)

Getting Started


After downloading a custom visual template and saving it to your computer or another location, the next step is to import that visual template into a report so that it is added, as an option, to your Visualization pane.

1. Open Power BI and select the report where you want to add the custom visualization.
   



2. Open the report in Editing View.
   



3. In the Visualizations pane, select the ellipses (...).
   

1. Select Import and navigate to the location where you saved the downloaded custom visualization (.pbiviz file).
   



2. IMPORTANT: Review the warning and ensure the visual comes from a trustworthy source. Microsoft recommends you work with your IT department if you're not sure whether to use a specific Custom Visual you obtained from the Power BI visuals gallery, through email or from some other source. See Review custom visuals for security and privacy.
   



3. Select Open. The custom visualization is added to the Visualization pane.
   



4. A custom visual template is added to the Visualization pane of a specific report when imported. It is now available for you to select and use in that report. If you'd like to use the visual in another report, you need to import it into the Visualization pane of that report as well. When a report with a custom visual is saved using the Save As option, a copy of the custom visual template is saved with the new report. You cannot currently pin a custom visual to a dashboard.
   



5. Still in Editing View, select the custom visualization icon. This adds a watermark (template) to your report canvas.
   



6. Drag fields onto the template to create the visualization. This example shows the Table Heatmap custom visualization.
   



7. Continue to work with and explore this visualization as you would any other (native) visualization in Power BI.