Learn how you can publish your custom visual to the Office store for others to discover and use.
Once you have created your custom visual, you may want to publish it on the Office store for others to discover and use. There is some preperation that needs to be done before you can do that. For more information on how to create a custom visual, see Use developer tools to create custom visuals.
What is the Office store? Simply put, it is the place to find apps (add-in) for your Office 365 software. The Office store connects millions of users of Office 365 to solutions that help them get work done more efficiently, more insightfully or more beautifully than before.
One you're done coding and testing your custom visual and have packaged it into a pbiviz file, you should also have the following ready for your submission.
|Pbiviz package contains all the required metadata||Yes||Visual name |
Author name and email
|Sample .pbix report file||Yes||To showcase your visual, you should help users to get acquainted with the visual. You should emphasize on the value the visual brings to the user and give examples of usage, formatting options, etc. You can also add a "hints" page at the end with some tips and tricks, things to avoid and the like.|
|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 300px (width) x 300px (height). It can be no larger than 512kb for the file size.|
|Screenshots||Yes||You must provide at least one screenshot. The format can be .png, .jpg, .jpeg or .gif. It must be exactly 1366px (width) x 768px (height). It can be no larger than 1024kb for the file size. For greater usage, add text bubbles to articulate the value proposition of key features shown in each screenshot.|
|Support download link||Yes||Provide the URL to support customers who have issues with your visual. The format of your URL should include https:// or http://.|
|End user license agreement (EULA)||Yes||You must upload a EULA file. This can be either your own EULA or use the default EULA within the Office store for Power BI custom visuals. To use the default EULA, paste the following URL in the seller dashboard's "End User License Agreement" file upload dialog: https://visuals.azureedge.net/app-store/Power BI - Default Custom Visual EULA.pdf.|
|Video link||No||To increase the interest of users for your custom visual, it is advised to provide a link to a video about your visual. The format of your URL should include https:// or http://.|
|GitHub repository||No||It is preferred to have a valid and public link to a GitHub repository with sources of your visual and sample data in it to allow other developers to provide feedback and propose improvements to your code.|
Submission starts with sending an email to the Power BI custom visuals submission team. You can email email@example.com.
Attach the .pbiviz file and the sample report .pbix file in your email. The Power BI team will reply back with instructions and a app package XML file to upload. This XML app package is required in order to submit your visual through the Office developer center.
To improve quality and assure that existing reports are not breaking, updates to existing visuals will take an additional 2 weeks to reach production environment after approval in the store.
Once you get the app package XML from the Power BI team, navigate to the Office developer center to submit your visual to the Office store.
You must have a valid Office developer account to log in to the Office developer center. An Office developer account must be a Microsoft Account (Live ID, e.g. hotmail.com or outlook.com).
You must send an email with the .pbiviz file and the .pbix file to the Power BI team before submitting to the Office store. This is so the Power BI team will upload the files to the public share server. Otherwise, the Office store will not be able to retrieve the files. You must send the files with each new visual submission, update to existing visual and fixes to rejected submissions by the Office store.
Follow the below steps to complete the submission.
Select Add a new app.
Select Power BI custom visual and then Next.
Select the + under App package and select the app package XML file that you received from the Power BI team from the open file dialog.
You should receive an approval that this is a valid Power BI app package.
Fill out the General info details.
Upload your visual's logo by selecting the + under App logo. Then select the icon file in the open file dialog. The file must be .png, .jpg, .jpeg or .gif. It must be exactly 300px (width) x 300px (height) and no larger than 512kb in size.
Fill out the Support documents details.
End User License Agreement (EULA)
You must upload a EULA file. This can be either your own EULA or use the default EULA within the Office store for Power BI custom visuals. To use the default EULA, paste the following URL in the seller dashboard's "End User License Agreement" file upload dialog: https://visuals.azureedge.net/app-store/Power BI - Default Custom Visual EULA.pdf.
Select Next to proceed to the Details page.
Select Language and pick a language from the list.
Fill out the "Description" details.
Upload at least one screenshot. The format can be .png, .jpg, .jpeg or .gif. It must be exactly 1366px (width) x 768px (height). It can be no larger than 1024kb for the file size. For greater usage, add text bubbles to articulate the value proposition of key features shown in each screenshot.
If you'd like to add more languages, select Add a language and repeat steps 10 and 11. Adding more languages will help your users view the custom visual details in their own language. Languages that will not be listed will default to the first language selected.
When you are done adding languages, select Next to proceed to the Block access page.
If you want to prevent customers in specific countries or regions from using or purchasing your app, check the box and select from the list.
Select Next to proceed to the Pricing page.
Currently, only free visuals are supported and additional purchases inside the visual (In-App purchase) are not allowed. Select This app is free.
You can now select Save as draft" and submit later, or select **Submit for approval to submit the custom visual to the Office store.
You can review the validation policies.
After submission, you will be able to view the submission status in the app dashboard.
Once your visual is created, you can optionally get your visual certified. This means it can run within the Power BI service and be used with other features of the service such as exporting to PowerPoint. For more information, see Getting a custom visual certified.
More questions? Try asking the Power BI Community