Get a Power BI visual certified
Certified Power BI visuals are Power BI visuals in AppSource that meet the Microsoft Power BI team code requirements. These visuals are tested to verify that they don't access external services or resources, and that they follow secure coding patterns and guidelines.
The certification process is optional. Power BI visuals that are not certified, are not necessarily unsafe Power BI visuals. Some Power BI visuals aren't certified because they don't comply with one or more of the certification requirements. For example, a map Power BI visual connecting to an external service, or a Power BI visual using commercial libraries.
Microsoft is not the author of third-party Power BI visuals. To verify the functionality of third-party visuals, contact the author of the visual directly.
To get your Power BI visual certified, your Power BI visual must comply with the requirements listed in this section.
Your Power BI visual has to be approved by Partner Center. We recommend that your Power BI visual is already in AppSource. To learn how to publish a Power BI visual to AppSource, see Publish Power BI visuals to Partner Center.
Before submitting your Power BI visual to be certified, verify that it complies with the guidelines for Power BI visuals.
When submitting the Power BI visual, make sure that the compiled package exactly matches the submitted package.
Code repository requirements
The repository must contain the following:
- Code for only one Power BI visual. It can't contain code for multiple Power BI visuals, or unrelated code.
- A branch named certification (lowercase required). The source code in this branch has to match the submitted package. This code can only be updated during the next submission process, if you're resubmitting your Power BI visual.
If your Power BI visual uses private npm packages, or git submodules, you must provide access to the additional repositories containing this code.
To understand how a Power BI visual repository looks, review the GitHub repository for the Power BI visuals sample bar chart.
Use the latest version of the API to write the Power BI visual.
The repository must include the following files:
- .gitignore - Add
distto this file. The code cannot include the node_modules, .tmp or dist folders.
- capabilities.json - If you are submitting newer version of your Power BI visual with changes to the properties in this file, verify that they do not break reports for existing users.
- package.json. The visual must have the following package installed:
Make sure that the following commands don't return any errors.
npm audit- Must not return any warnings with high or moderate level.
- TSlint from Microsoft with the required configuration. This command must not return any lint errors.
Use the latest version of powerbi-visuals-tools to write the Power BI visual.
You must compile your Power BI visual with
pbiviz package. If you're using your own build scripts, provide a
npm run package custom build command.
Source code requirements
Verify that you follow the Power BI visuals additional certification policy list. If your submission doesn't follow these guidelines, the rejection email from Partner Center will include the policy numbers listed in this link.
Follow the code requirements listed below to make sure that your code is in line with the Power BI certification policies.
- The code must support the Rendering Events API.
- Ensure DOM is manipulated safely. Use sanitization for user input or user data, before adding it to DOM.
- Use the sample report as a test dataset.
- Accessing external services or resources. For example, no HTTP/S or WebSocket requests can go out of Power BI to any services.
D3.html(user data or user input).
- Arbitrary or dynamic code such as
eval(), unsafe use of
setinterval(user input function), and user input or user data.
Submitting a Power BI visual for certification
You can request to have your Power BI visual certified by the Power BI team via Partner Center.
The Power BI certification process might take time. If you're creating a new Power BI visual, we recommend that you publish your Power BI visual via the Partner Center before you request Power BI certification. This ensures that the publishing of your visual is not delayed.
To request Power BI certification:
- Sign in to Partner Center.
- On the Overview page, choose your Power BI visual, and go to the Product setup page.
- Select the Request Power BI certification check box.
- On the Review and publish page, in the Notes for certification text box, provide a link to the source code and the credentials required to access it.
Private repository submission process
If you're using a private repository such as GitHub to submit your Power BI visual for certification, follow the instructions in this section.
- Create a new account for the validation team.
- Configure two-factor authentication for your account.
- Generate a new set of recovery codes.
- When submitting your Power BI visual, provide the following:
- A link to the repository
- Login credentials (including a password)
- Recovery codes
- Read-only permissions to our account (pbicvsupport)
Certified Power BI visual badges
Once a Power BI visual is certified, it gets a designated badge that indicates that it's certified.
Certified Power BI visuals in AppSource
When searching online for Power BI visuals in AppSource, a small yellow badge on the visual's card indicates that it's a certified Power BI visual.
After clicking the Power BI visual card in AppSource, a yellow badge titled PBI Certified indicates that this Power BI visual is certified.
Certified Power BI visuals in the Power BI interface
When importing a Power BI visual from within Power BI (Desktop or service), a blue badge indicates that the Power BI visual is certified.
You can display only certified Power BI visuals, by selecting the Power BI Certified filter option.
Deploying to AppSource is a process that may take some time. Your Power BI visual will be available to download from AppSource when this process is complete.
When will users be able to download my visual?
If you submitted a Power BI visual for the first time, users will be able to download it a few hours after you receive an email from AppSource.
If you submitted an update to an existing Power BI visual, users will be able to download it within two weeks of your submission.
The version field in AppSource will be updated with the day your Power BI was approved by AppSource, approximately a week after you submitted your visual. Users will be able to download the updated visual but the updated capabilities will not take effect. Your visual's new capabilities will affect the user's reports after about a two weeks.
When will my Power BI visual display a certification badge?
If you submitted a Power BI visual for the first time, the certification badge will appear within a day of receiving the approval email from AppSource.
If you're requesting certification for an existing Power BI visual, the certification badge will be visible within two weeks of your submission.
Developing a Power BI circle card visual tutorial.