Skip to content
JavaScript library for embedding Power BI into your apps. Check out the docs website and wiki for more information.
TypeScript JavaScript HTML
Branch: master
Clone or download
Latest commit 26312af Jan 8, 2020


JavaScript library for embedding Power BI into your apps.

Build Status NPM Version Nuget Version NPM Total Downloads NPM Monthly Downloads GitHub tag Gitter


See the wiki for more details about embedding, service configuration, setting a default page, page navigation, dynamically applying filters, and more.

Code Docs

See the code docs for detailed information about classes, interfaces, types, etc.


New live demo for a sample application using the powerbi-client library in scenarios such as page navigation, applying filters, updating settings, and more.


Install via Nuget:

Install-Package Microsoft.PowerBI.JavaScript

Install from NPM:

npm install --save powerbi-client

Installing beta versions:

npm install --save powerbi-client@beta

Include the library via import or manually

Ideally you would use a module loader or a compilation step to import using ES6 modules as:

import * as pbi from 'powerbi-client';

However, the library is exported as a Universal Module and the powerbi.js script can be included before your app's closing </body> tag as:

<script src="/powerbi-client/dist/powerbi.js"></script>

When included directly, the library is exposed as a global named powerbi-client. There is also another global named powerbi which is an instance of the service.

You can’t perform that action at this time.