# powerbi-client JavaScript library for embedding Power BI into your apps. [](https://travis-ci.org/Microsoft/PowerBI-JavaScript) [](https://www.npmjs.com/package/powerbi-client) [](https://bower.io/search/?q=powerbi-client) [](https://www.nuget.org/packages/Microsoft.PowerBI.JavaScript/) [](https://www.npmjs.com/package/powerbi-client) [](https://www.npmjs.com/package/powerbi-client) [](https://github.com/Microsoft/PowerBI-JavaScript/tags) [](https://gitter.im/Microsoft/PowerBI-JavaScript) ## Wiki See the [wiki](https://github.com/Microsoft/PowerBI-JavaScript/wiki) for more details about embedding, service configuration, setting default page, page navigation, dynamically applying filters, and more. ## Code Docs See the [code docs](https://microsoft.github.io/PowerBI-JavaScript) for detailed information about classes, interfaces, types, etc. ## Demo New [live demo](https://microsoft.github.io/PowerBI-JavaScript/demo) for sample application using the powerbi-client library in scenarios such as page navigation, applying filters, updating settings, and more. ## Installation Install via Nuget: `Install-Package Microsoft.PowerBI.JavaScript` Install from NPM: `npm install --save powerbi-client` Install from Bower: `bower install powerbi-client --save` Installing beta versions: `npm install --save powerbi-client@beta` ## Include the library via import or manually Ideally you would use module loader or compilation step to import using ES6 modules as: ```javascript 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 apps closing `

` tag as: ```html ``` When included directly the library is exposd as a global named 'powerbi-client'. There is also another global `powerbi` which is an instance of the service.