Tutorial: Adding a PREMIUM License Manually or via a Theme file

You are here:

This article provides a step-by-step guide for adding a license to our Power BI Premium visuals. You can license your visual in two ways:

  • Manually via de Power BI user interface or
  • Automatically via a Theme file.

Adding a License Manually

Follow these steps to license the visual in the Power BI user interface:

  1. In Power BI (Desktop), add the visual to your Power BI Report
  2. Click the Format your visual icon in the Visualizations pane or
  3. Locate and open the existing report with the visual
  4. Click the visual to activate the Format visual pane
  5. Expand the License card and paste the license information (you received per e-mail) into the License Name and License Key fields
  6. If the license information is entered correctly, you should see the expiry date of the license in the second field. Your visual is now successfully licensed!
  7. Save your changes and Publish to the service.

Adding a License via a Theme file

You can also add the license to a Theme.json file to avoid having to add it to each visual individually.

Power BI Themes are defined in so called JSON files. If you add your license information in a theme file it will apply the license to each visual within that report.

How to create or update and import a theme file:

  • Create a new JSON file or edit an existing one
  • Add the visualStyles values (see example below)
  • Save the .json file
  • In Power BI (Desktop), create a new report and add the visual or
  • Locate and open the existing report with the visual
  • Go to the View tab and click on the drop-down arrow
  • Choose Browse for themes
  • Locate and select your Theme.json file
  • Click the Open button to import it
  • A File successfully added dialog will show up
  • Click the Got it button
  • Your report book and all the pages will get the refreshed License
  • Save and Publish to the service.

If you already have a corporate Theme file, add the “visualStyles” properties and paste it to your Theme file.

License properties

Name on user interface

License Name

License Key

Name in Theme file



The License Name and License Key are supplied to you specifically via e-mail. Add the following example to your Theme file and replace the text between quotes with your own license information.

"visualStyles": {
       "*": {
          "*": {
             "license": [{
                 "licenseName": "YOUR LICENSE NAME",
                 "licenseKey": "YOUR LICENSE KEY"
Table of Contents