Publish a map-enabled report to the web

Note:

You need the following account and license types to use this workflow:

• Microsoft license—You need a Microsoft 365 license, role Contributor or higher, to publish a map-enabled report containing public data to the web.
• ArcGIS account type—You must sign in to an ArcGIS account to perform this workflow.

You can publish map-enabled ArcGIS for Power BI reports containing public data to the web.

See Content sharing for general information about sharing ArcGIS content.

Sharing reports containing public data does not require viewers of the report to sign in to their ArcGIS account. If the report contains proprietary data from ArcGIS, see the Embed a map-enabled report workflow.

After you design a map-enabled report, use Publish to web to add it to a public website or article. Although Contributors typically use Power BI desktop to create reports, this workflow is also available in the Power BI service (powerbi.com).

Requirements

To use Publish to web in Power BI, the following requirements must be met:

• Power BI data used to create the ArcGIS for Power BI map must use latitude and longitude coordinates for locations or EsriJSON in the Location field well. If the Location field well contains addresses or standard boundaries, publishing to the web will fail.
• The map to be published cannot contain secure or privately owned data. Maps containing private data cannot be published to the web.
• You must be signed in to a valid ArcGIS account with a user type and role that has been granted appropriate permissions by your account administrator to publish content.
• You must be signed in to Microsoft Power BI with a Microsoft Pro or Premium account. Viewers do not need to be Power BI users or have an account to view the published reports.
• A published map can contain a maximum of 30,000 locations.
• You must run the ArcGIS for Power BI publishing check before generating an embed code for the report.
• Viewers cannot sign in to published reports.

Create and validate a map-enabled report

Use Power BI desktop or the Power BI service (powerbi.com) to create a map-enabled report.

Before you can publish the report to the web, run the Publish and embed validation in the ArcGIS for Power BI visualization to ensure that all requirements are met.

To validate a map-enabled report for publishing, complete the following steps:

1. Sign in to your ArcGIS account.
2. Create a Microsoft Power BI report that includes an ArcGIS for Power BI map and save the report.
3. From the Map tools, click Settings .

   The Settings pane appears.

4. In the Settings pane, in the Embed and publish check category, click Validate.

   Embed and publish check does not appear in the Settings pane unless you are signed in.

   The check verifies that all requirements for publishing the map have been met, including the following:

   • Power BI location data is in latitude and longitude coordinates.
   • The map contains only publicly accessible data from ArcGIS.
   • No layers contain secured or premium content.

5. Review the message that appears when the check completes, and click Show error details to view information about an error if applicable.

   • Layers that pass all requirements appear with a green check mark .
   • Items that do not meet the requirements appear with a red mark .

6. Correct any errors in the map, save the report, and run Embed and publish check again.

   When the check completes successfully, a message appears indicating that the map has passed and can be published with the report.

Publish a map-enabled report

Once you've created and checked the map-enabled report, you can publish it to the Power BI platform. The report must be in the Power BI service (powerbi.com) to enable embedding or publishing to the web. You generate an embed link associated with the report and copy the resulting code to the web page.

To publish a map-enabled report to the web, complete the following steps:

1. From the Power BI menu, click File > Publish to Power BI, or click the Publish button on the Power BI ribbon.

   You can also manually update the .pbix file to the Power BI service.

2. In the Publish to Power BI pane, choose My Workspace and click Select.

   When the report is successfully published, a confirmation message appears.

3. Close Power BI desktop.
4. Open the report in the Power BI service and save the report.

   You must open the report in the Power BI service and save the report before you can publish it to the web or embed it in a website, whether you're working with a new or existing report. This allows ArcGIS for Power BI to verify that the requirements for publishing or embedding are met.

5. To choose Publish to web, do one of the following:
   • In Reading view, click Share > Embed report > Publish to web (public).

     

   • In edit mode, click File > Publish to web.

     

   If you don't see the Publish to web options, contact your Power BI administrator to request permission to create embed codes.

   The Publish to web pane appears.

6. In the Embed in a public website panel, click Create embed code.
7. Read the acknowledgement about public sharing, ensuring that you have permission to share the contents of the report publicly. If you agree, click Publish, or click Close to cancel the operation.

   When the embed code is successfully generated, a confirmation message appears listing two options that you can use to embed the report in a public website.

8. Embed the report by doing one of the following:
   • To embed the link in an email or blog post, copy the link from the first text box into the body of the email message or blog post.
   • To embed the report in a web page, copy the iframe code from the second text box using the drop-down menu to specify the size of the iframe to use to contain the report into the web page and publish the page.

   The report appears on the published web page.

Delete an embed code

All published reports must have a corresponding embed code associated with them. These codes are stored in your Power BI workspace and can be accessed at any time. When you delete an embed code, the associated report is no longer published and does not appear on pages where it was published.

To delete an embed code, complete the following steps:

1. Open the published report in the Power BI service.
2. On the main Power BI ribbon, click More options to view the context menu and click Settings > Manage embed codes.

   A list of your active publish to web codes appears.

3. Click the code to delete, click More options , and choose Delete.
4. On the confirmation message that appears, click Delete.

   When the code is deleted, the report associated with that code is no longer published and does not appear in published web pages.

   For more information about publishing to the web, see the Microsoft Publish to web in Power BI article.