You've downloaded a custom visual template and saved 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.

Watch Will download a custom visual and add it to his report. Then follow the step-by-step instructions below the video to try it yourself.

Important:

A custom visual template is added to a specific report when imported. If you'd like to use the visual template in another report, you need to import it into 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.

  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 (...).

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

  5. 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.

  6. Select Open. The custom visualization icon (also called template) is added to the Visualization pane.

    A custom visual template is added to a specific report's Visualization pane 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 that report's Visualization pane 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.

    Once you import a custom visual template you cannot remove it from that specific report's Visualization pane. If you've used it to create a visualization, you can remove the visualization; but the icon will remain in the Visualization pane.

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

  8. Drag fields onto the template to create the visualization. Optionally, pin the visual to a dashboard. This example shows the Table Heatmap custom visualization.

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

Considerations and troubleshooting

  • In order to enable custom visuals to be supported in export to PowerPoint, or displaying in emails received when a customer subscribes to report pages, they need to be defined as Certified custom visuals that have passed the Microsoft custom visual certification process. To see the list of Certified custom visuals and to learn more about the certification process, see Certified custom visuals.

Next steps

Download and use custom visuals from the Office store
Microsoft's custom visual playlist on YouTube
Visualizations in Power BI
Custom Visualizations in Power BI
Use custom visualizations in Power BI Desktop
Review custom visuals for security and privacy
Getting started with custom visuals developer tools (Preview)
Publish custom visuals to the Office store
Video: Creating custom visualizations for Power BI with Sachin Patney and Nico Cristache

More questions? Try asking the Power BI Community