Embedded analytics with Power BI

The Power BI service (SaaS) and the Power BI Embedded service in Azure (PaaS) have APIs for embedding your dashboards and reports. When embedding content, this gives you access to the latest Power BI features such as dashboards, gateways, and workspaces.

You can go through the Embedding setup tool to quickly get started and download a sample application.

Choose the solution that is right for you:

PBIE sample


Embedding with a Premium Per User (PPU) license is only supported with SaaS embedding, and a license is required for each user.

Use APIs

There are two main scenarios for embedding Power BI content:

  • Embedding for your organization's users (who have Power BI licenses).

  • Embedding for your users and customers without requiring Power BI licenses.

The Power BI REST API allows for both scenarios.

For customers and users without Power BI licenses, you can embed dashboards and reports into your custom application, using the same API to either service your organization or your customers. Your customers see the application-managed data. Also, your organization's Power BI users have additional options to view their data directly in Power BI or in the embedded application's context. You can take full advantage of the JavaScript and REST APIs for your embedding needs.

To understand 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 type of embedding requires your application's users sign into the Power BI service to view the content. Once someone in your organization signs in, they only have access to dashboards and reports that they own or that someone shared with them in the Power BI service.

Organization embedding examples include internal applications such as SharePoint Online, Microsoft Teams integration (you must have Admin rights), and Microsoft Dynamics.

To embed for your organization, see Tutorial: Embed Power BI content into an application for your organization.

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

You can go through the Embedding setup tool to get started and download a sample application that walks you through integrating a report for your organization.

Embedding for your customers

Embedding for your customers lets you embed dashboards and reports for users who don't have a Power BI account. This type of embedding is also known as Power BI Embedded.

Power BI Embedded is a Microsoft Azure service that lets independent software vendors (ISVs) and developers quickly embed visuals, reports, and dashboards into an application. This embedding is done through a capacity-based, hourly metered model.

Embedding flow for embedding for your customers

Power BI Embedded has benefits for an ISV, their developers, and customers. For example, an ISV can start creating visuals for free with Power BI Desktop. By minimizing visual analytic development efforts, ISVs achieve faster time to market and stand out from competitors with differentiated data experiences. ISVs can also opt to charge a premium for the additional value they create with embedded analytics.

With Power BI Embedded, your customers don't need to know anything about Power BI. You can use two different methods to create an embedded application:

  • Power BI Pro account
  • Service principal

The Power BI Pro account acts as your application's master account (think of it as a proxy account). This account allows you to generate embed tokens that provide access to your application's Power BI dashboards and reports.

Service principal can embed Power BI content into an application using an app-only token. It also allows you to generate embed tokens that provide access to your application's Power BI dashboards and reports.

Developers using Power BI Embedded can spend time focused on building their application's core functionality rather than spending time developing visuals and analytics. They can rapidly meet customer report and dashboard demands and embed easily with fully documented APIs and SDKs. By enabling easy-to-navigate data exploration in apps, ISVs allow customers to make quick, data-driven decisions in context from any device.


While embedding requires the Power BI service, your customers do not need to have a Power BI account to view your application's embedded content.

When you're ready to move to production, your workspace must be assigned to a capacity. Create a Power BI Embedded capacity in Microsoft Azure, to use with your applications.

For embedding details, see How to embed Power BI content.

Next steps

You can now try to embed Power BI content into an application, or try to embed Power BI content for your customers.

More questions? Try asking the Power BI Community