Publish to web

After you design a map-enabled report, you can use the Power BI Publish to web feature to add it to a public website or blog article. Although designers 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:

  • You must be signed in to a valid ArcGIS account with the appropriate user type.
  • To create a map-enabled report in Power BI, you must be signed in to Power BI with a Pro or Premium account. Consumers do not need to be Power BI users to view published reports.
  • Power BI data used to create the ArcGIS for Power BI map must use latitude and longitude coordinates for locations. If the Location field well contains addresses or standard boundaries, publishing to the web will not work.
  • A published map can contain a maximum of 30,000 locations.
  • The map must not contain secure data. Maps with secure data cannot be published.
  • You must run the ArcGIS for Power BI publishing precheck before generating an embed code for the report.
  • Consumers cannot sign in to published reports.

Create and check a map-enabled report

Use ArcGIS for Power BI Desktop or the ArcGIS for 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 check on the ArcGIS for Power BI visualization to ensure that all requirements are met.

To check a map-enabled report for publishing, do the following:

  1. Create a report that contains an ArcGIS for Power BI map and save the report.
  2. With the ArcGIS for Power BI visual active, click Settings Settings to view the Settings pane.
    Note:

    If necessary, click Map tools Map tools to expand the toolset.

  3. In the Settings pane, in the Embed and publish check category, click Validate.
    Note:

    You must be signed in to a valid ArcGIS organizational account to see the Embed and publish check section in the Settings pane.

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

    The check verifies that all requirements for publishing the map have been met. These include the following:

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

  5. Review the message that appears when the check completes.

    Layers that pass all requirements appear with a green checkmark Pass. If an item does not meet the requirements, a red mark Fail appears beside the item. Click Show error details to view information about the error.

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

    When the check completes successfully, a message appears stating that the map has passed and is ready to be published with the report.

Publish a map-enabled report to the web

When you've created and checked your map-enabled report, publish the report 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 your web page.

To publish a map-enabled report to the web, follow these steps:

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

    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 select Publish to web, do one of the following:
    • In Reader view, click Share to view the context menu and choose Publish to web (public).
      In Reader view, click the Share button to access the Publish to web feature.
    • In Edit mode, click File > Publish to web.
      In Edit mode, expand the File menu to access the Publish to web feature.
    Note:

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

  6. In the Embed in a public website pane, 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.
  8. When the embed code is successfully generated, a confirmation appears, listing two options that you can use to embed the report in a public website. Do one of the following:
    • To embed a link in an email or blog article, copy the link in the first field and paste it into the body of the email message or article.
    • To embed the report in a web page, copy the iFrame code from the second field, using the drop-down menu to specify the size of the frame to use to contain the report. Paste the code into your web page and publish the page.

The report appears on the published web page.

Manage embed codes

All published reports must have a corresponding embed code associated with them. These codes are stored in your Power BI Workspace and can be managed 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 remove an embed code, follow these steps:

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

    A list of all your active publish to web codes appears.

  3. To delete a code, select it in the list, click More options More to view the context menu, and choose Delete.
  4. On the confirmation message that appears, click Delete.

When the code is successfully 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 Publish to web in Power BI.