Publish Power BI visuals to Partner Center

Once you have created your Power BI visual, you may want to publish it to the AppSource for others to discover and use. For more information about creating a Power BI visual, see Developing a Power BI circle card visual.

What is AppSource?

AppSource is the place to find SaaS apps and add-ins for your Microsoft products and services.

Screenshot of Power B I visuals in AppSource.

Preparing to submit your Power BI visual

Before submitting a Power BI visual to AppSource, make sure you've read the Power BI visuals guidelines and tested your custom visual.

When you are ready to submit your Power BI visual, verify that your visual meets all the requirements listed below.

Item Required Description
Pbiviz package Yes Pack your Power BI visual into a Pbiviz package containing all the required metadata.
Visual name
Display name
GUID
Version
Description
Author name and email
Sample .pbix report file Yes To showcase your visual, you should help users to get familiar with the visual. Highlight the value that the visual brings to the user and give examples of usage and formatting options. You can also add a "hints" page at the end with some tips and tricks and things to avoid.
The sample .pbix report file must work offline, without any external connections.
Icon Yes You should include the custom visual logo that will appear in the store front. The format can be .png, .jpg, .jpeg or .gif. It must be exactly 300 px (width) x 300 px (height).
Important! Please review the AppSource store images guide carefully, before submitting the icon.
Screenshots Yes Provide at least one screenshot. The format can be .png, .jpg, .jpeg or .gif. The dimensions must be exactly 1366 px (width) by 768 px (height). The size of the file can't be larger than 1024 kb.
For greater usage, add text bubbles to articulate the value proposition of key features shown in each screenshot.
Support download link Yes Provide a support URL for your customers. This link is entered as part of your Partner Center listing, and is visible to users when they access your visual's listing on AppSource. The format of your URL should include https:// or https://.
Privacy document link Yes Provide a link to the visual's privacy policy. This link is entered as part of your Partner Center listing, and is visible to users when they access your visual's listing on AppSource. The format of your link should include https:// or https://.
End-user license agreement (EULA) Yes You must provide an EULA file for your Power BI visual. You can use the standard contract, Power BI visuals contract, or your own EULA.
Video link No To increase the interest of users for your custom visual, provide a link to a video about your visual. The format of your URL should include https:// or https://.
GitHub repository No Share a public link to a GitHub repository with sources of your Power BI visual and sample data. This allows other developers an opportunity to provide feedback and propose improvements to your code.

Getting an app package XML

To submit a Power BI visual you need an app package XML from the Power BI team. To get the app package XML, send an email to the Power BI visuals submission team (pbivizsubmit@microsoft.com).

Before you create the pbiviz package, you must fill the following fields in the pbiviz.json file:

  • description
  • supportUrl
  • author
  • name
  • email

Attach the pbiviz file and the sample report pbix file to your email. The Power BI team will reply back with instructions and an app package XML file to upload. This XML app package is required in order to submit your visual through the Office developer center.

Note

To improve quality and assure that existing reports are not breaking, updates to existing visuals will take an additional two weeks to reach production environment after approval in the store.

Submitting to AppSource

To submit your Power BI visual to AppSource, you need to get an app package from the Power BI team, and then submit it to Partner Center.

Getting the app package

You must send an email with the pbiviz file and the pbix file to the Power BI team before submitting to AppSource. This allows the Power BI team to upload the files to the public share server. Otherwise, the store will not be able to retrieve the files.

The Power BI team has to check files for new Power BI visual submissions, updates to existing Power BI visuals, and fixes to rejected submissions.

Submitting to Partner Center

To submit your Power BI visual to Partner Center, you have to be registered with Partner Center. If you're not yet registered, Open a developer account in Partner Center.

Note

Individual publishers can use one of these methods to submit a Power BI visual:

  • If you have an old Seller Dashboard account, you can continue using this account's credentials to sign into partner Center.
  • If you don't have an old Seller Dashboard account, and are not registered to Partner Center, you'll need to Open a developer account in Partner Center using your work email.

Follow the steps below to submit your Power BI visual to Partner Center. For more information about the submission process, see Submit your Office solution to AppSource via Partner Center.

  1. Log into Partner Center.

  2. On the left pane, select OFFICE STORE.

  3. Select Overview.

  4. Select Create a new and from the drop-down menu, select Power BI visual.

    Screenshot of creating a new Power B I visual in the office store tab in Partner Center.

  5. In the Create a new Power BI visual window, enter a name for your Power BI visual and select Create.

  6. Select Packages and upload your Power BI visual XML app package.

  7. Select Properties and provide the required information.

  8. If your product requires additional purchase, select Product setup and check the Associated service purchase check box.

  9. (Optional) If you want to certify your visual, select Product setup and check the Power BI certification check box.

    Tip

    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.

  10. Select Product setup and click Review and publish.

Tracking submission status and usage

You can review the validation policies.

  • After submission, you will be able to view the submission status in the app dashboard.

  • To understand when your Power BI visual will be available to download from AppSource, review the Power BI visuals publication timeline.

Certify your visual

Once your visual is created, if you want you can get your visual certified.

Next steps