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.


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 Desktop and select the report where you want to add the custom visualization. Open the report in Editing View.

  2. There are two options to import a custom visual template: from the File menu or from the Visualizations pane.

    From the Desktop File menu

    • On the report File menu, choose Import > Power BI Custom Visual. You must be in the editing view.

    From the Visualization pane - In the Visualizations pane, choose Insert (…). - Select Import a custom visual.

  3. Review the warning.

    A custom visual has access to the data in the report you use in the custom visual, and can perform actions on your behalf. If you share the report with others, when they view the report the custom visual can do the same, but for your co-workers. Take care to review the custom visual to ensure it 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.

  4. Select a .pbiviz file in the Open dialog.

  5. An icon (also called a template) is added to your Visualizations pane.

  6. Select the custom visual template to add it to your report as you would with any of the other templates in the Visualizations pane. Add fields and filters and build your visual.

  7. Format the custom visual as you would any other visual. From the Visualizations pane, select the paintbrush icon. The formatting options available will vary by visual type.

Considerations and troubleshooting

Next steps

Download and use custom visuals from the Office store
Add a custom visual to a report in the Power BI Service
Publish custom visuals to the Office store
Visualizations in Power BI
Custom Visualizations in Power BI
The Power BI custom visuals gallery
More questions? Try the Power BI Community