Embedding with Power BI

Power BI offers APIs for embedding your dashboards and reports into applications. The Power BI APIs offer a consistent set of capabilities and access to the latest Power BI features – such as dashboards, gateways and app workspaces – when embedding your content.

A single API

There are two main scenarios when embedding Power BI content. Embedding for your organization and embedding for your customers. The Power BI REST API allows for both scenarios. This will allow you to embed dashboards and reports into your custom application, using the same API to either service your organization or your customers. You can take full advantage of the JavaScript and REST APIs for your embedding needs.

To view a sample of how embedding works, see the JavaScript embed sample.

Embedding for your organization

Embedding for your organization allows you to extend the Power BI service. This requires that the end user of your application sign into the Power BI service when you want to view your content. Once someone in your organization signs in, they will only have access to dashboards and reports that have been shared with them in the Power BI service.

Examples of embedding for your organization include internal web application, the SharePoint Online web part and Microsoft Teams integration.

For embedding for your organization, see the following:

Self-service capabilities, such as edit, save and more, are available through the JavaScript API when embedding for Power BI users.

Embedding for your customers

Embedding for your customers provides the ability to embed dashboards and reports to users that don't have an account for Power BI. Your customers don't need to know anything about Power BI. At least one Power BI Pro account is needed. The Power BI Pro account will act as a master account for your application. Think of this as a proxy account. The Power BI Pro account also allows you to generate embed tokens that provide access to dashboards and reports within the Power BI service.

An example of embedding for your customers is an ISV application being sold to other companies.

Embedding flow for embedding for your customers

To embed dashboards, reports and tiles, you would use the same APIs that you would use for embedding for your organization.


While embedding has a dependency on the Power BI service, there is not a dependecy on Power BI for your customers. They do not need to sign up for Power BI to view the embedded content in your application.

When you are ready to move to production, your app workspace must be assigned to a capacity. Power BI Embedded, within Microsoft Azure, offers capacity to use with your applications.

For details on how to embed, see How to embed your Power BI dashboards, reports and tiles.

If you were using the Power BI Workspace Collections service within Azure, see Migrate content from the Power BI Workspace Collections Azure service for information on how to migrate your content over.

Next steps

How to embed your Power BI dashboards, reports and tiles
How to migrate Power BI Embedded workspace collection content to Power BI
Power BI Premium - what is it?
JavaScript API Git repo
Power BI C# Git repo
JavaScript embed sample
Embedded analytics capacity planning whitepaper
Power BI Premium whitepaper

More questions? Try asking the Power BI Community