Edit

Automatically install Power BI apps when embedding content for your organization

  • Article

APPLIES TO:  App owns data  User owns data

To embed content from an app, the user needs access to the app that contains the content to embed. If the app isn't installed, the embedding will fail. To make embedding content from an app easier, you can set up automatic app installation in PowerBI.com for your organization. Defining automatic app installation is a tenant level action and applies to all apps.

Automatically install an app upon embedding content

If you have access to an app that isn't installed, and try to embed app content, the embedding will fail. To avoid this problem, allow automatic installation of the app upon embedding content. Allowing automatic installation means if the app the user tries to embed content from isn't installed, then the app is automatically installed for the user. Automatic app installation results in a smoother experience for the user.

Embedding for Power BI users (User owns data)

To allow the automatic installation of apps for your users, add the Create APIs permission to your application when you're registering your application. If you've already registered your app, add the Create APIs permission by changing your application's permissions.

Screenshot of the Power BI embedding setup tool, which shows the selected Create APIs option.

Provide the app ID in the embed URL. To provide the app ID, the app creator must install the app and then use one of the supported Power BI REST API calls, such as Get Reports or Get Dashboards. The app creator must take the embed URL from the REST API response. The app ID appears in the URL if the content is from an app. Use the embed URL to embed content.

Secure embedding

To use automatic application installation, the app creator must install the app. Then the app creator must go to the app on PowerBI.com, navigate to the report, and get the link. All other users with access to the app that can use the link can embed the report.

Considerations and limitations

  • You can only embed reports and dashboards in this scenario.

  • This feature is currently not supported for app-owns data or SharePoint embedding scenarios.