Publish a map-enabled report to the web

Note:

Some workflows may require specific privileges. For more information about user types, roles, and privileges, see the Accounts topic.

To use the content sharing features in ArcGIS for Power BI, your Microsoft 365 account should include a Power BI Pro or Premium plan with capabilities to publish reports. Users without this plan cannot embed or publish reports to the web.

If your Microsoft account has the appropriate permissions, 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.

Tip:

Although users 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 Esri JSON 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.
• Your Microsoft 365 account should include a Power BI Pro or Premium plan with capabilities to publish reports. Viewers of the published report do not need to be Power BI users or have an account.
• A published map can contain a maximum of 30,000 locations.
• You must run the ArcGIS for Power BI publishing check.
• Viewers of the report cannot sign in to published reports.

Create and validate a map-enabled report

Before you can publish the report to the web, run the ArcGIS for Power BI Embed and publish to web validation 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 and create and save a Microsoft Power BI report that includes an ArcGIS for Power BI map.
2. From the map tools, click Settings .
3. Click the Settings tab .
4. In the Embed and publish to web category, click Validate.

   Note:

   This category only appears on the Settings tab when you are signed in.

   The check verifies that all requirements for embedding 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.

   • Items that meet the requirements appear with a green check mark .
   • Items that do not meet the requirements appear with a red mark .
   • Click Show error details to view information about an error, if applicable.

6. Correct any errors in the map, save the report, and run the validation again.

   When the process 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 acknowledgment 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 from Power BI article.