Add the Power BI app to Microsoft Teams

This article describes how you can install, pin, and interact with Power BI directly inside Microsoft Teams. The Power BI personal app brings the entire basic Power BI service experience to Microsoft Teams.

Screenshot of Power BI app in Microsoft Teams.

The Power BI app in Microsoft Teams is one of the ways that you can collaborate with Power BI in Teams. The app is your personal experience of Power BI. It's as if the Power BI service lives inside Microsoft Teams. After you install it, you can do almost everything in Microsoft Teams that you can do in the Power BI service:

  • Create, view, and edit dashboards, reports, and apps.
  • Create and participate in workspaces.
  • Share content, either through email or through Microsoft Teams.

And there's a feature in the Power BI app in Teams that you don't see when you view the Power BI service (app.powerbi.com) in a web browser. On the Power BI home page in Teams, you can see all the Power BI tabs you've viewed, everywhere in Teams.

There are a few features that you can only access in the Power BI service in a browser. See the Known issues and limitations section of this article for details.

Note

When you install the Power BI app in Microsoft Teams, if you are in Microsoft 365 Targeted Release or Office Insiders Beta Channel, then the public preview of the Power BI app in Microsoft Outlook and Microsoft Office is also installed. Learn more about the public preview in Outlook and Office.

Requirements

In general, ensure these elements so you can install the Power BI app in Microsoft Teams:

  • Ensure the Power BI app is enabled in the Teams Admin center apps list.
  • Your users with a Power BI (Free) license can access personal analytics including using the built-in Teams analytics report and create reports in their My workspace.
  • Your users with Power BI (Free) licenses can also access content shared to them from a workspace that is part of a Power BI Premium capacity (P SKU).
  • Your users with a Power BI Pro or Premium Per User (PPU) license can share content with others or build content in workspaces.
  • Users will need to sign-in within the Power BI app for Teams or the Power BI service to activate their Power BI license.
  • Users meet the requirements to use the Power BI tab in Microsoft Teams.

Install the Power BI app

Select More added apps (...) in the left navigation bar, then search for and select Power BI.

Screenshot of installing the Power BI app in Microsoft Teams.

That's it! The Power BI app is installed in Microsoft Teams.

Pin the Power BI app to the Teams navigation pane

To keep the app available in Teams, pin it to the Teams navigation pane.

  • Right-click the Power BI icon in the Teams navigation pane, and select Pin.

    Screenshot of pinning the Power BI app to the Teams navigation pane.

That's it. Now it's there whenever you want to view your Power BI content in Teams.

Interact with your content in Microsoft Teams

Interacting with your content in Microsoft Teams is the same as in the Power BI service. You interact with your dashboards, reports, apps, or workspaces in the same ways.

You can even share a report to your coworkers in Microsoft Teams, from the Power BI app in Microsoft Teams.

Screenshot of Share in Microsoft Teams from the Microsoft Teams app.

The Power BI app in Microsoft Teams also features a hub for training. Select Learn to view the Learning Center.

Screenshot of Learning center in Power BI app in Microsoft Teams.

Differences in interactions

A few interactions are different in the Teams app than they are in the browser

  • When you're looking at a dashboard or report, you don't see the Power BI navigation pane. Select the Close button to go back to Home or the workspace.

    Screenshot of Close button in Power BI app in Microsoft Teams.

  • You can choose to open the report in the Power BI service instead of viewing it in Microsoft Teams. Select Open this on the web.

    Screenshot of Open this on the web button in Power BI app in Microsoft Teams.

Search for Power BI content in Teams

With the search experience in Teams, you can find recent reports, dashboards, and apps and open them within the Power BI app for Teams. Give the search experience a try.

  1. In the Teams search bar, type @Power BI.

    Note

    Be sure to include the space between "Power" and "BI".

    Type @Power BI in the Teams Search bar.

  2. Select an item from the list, or type something to search for.

    Select a dashboard, report, or other content from the list.

  3. Press Open.

    The first time you use this capability, you need to sign in.

  4. If you haven't installed the Power BI app yet, you'll be given the opportunity to add it.

    Search for the Power BI app in Teams

Increase Power BI app adoption in Teams

Your organization can make it easier for everyone to find and use data by installing and pinning (optional but recommended) the Power BI app for Teams for users.

Are you a leader in your organization? You can encourage individuals and teams to start using the Power BI app in Teams by installing it for themselves. Read the Guide to enabling your organization to use Power BI in Microsoft Teams to learn the options for broad and targeted roll-out and decide what’s right for your organization.

Install the Power BI app for Teams automatically

Are you a Power BI admin or a Teams admin? By default, the Power BI app for Teams will be installed automatically in some circumstances. See Install the Power BI app for Teams automatically for details. You can also encourage broader usage by pinning the app proactively in Teams through an app setup policy. It's useful to include Power BI as a pinned app, so users in Teams can easily find and use data. Automatic installation will start occurring after November 1, 2021 for users who visit the Power BI service and meet the criteria.

Power BI end users may see a notification in the Power BI service notification pane that the Microsoft Teams app was automatically installed.

Notification that the Microsoft Teams app was automatically installed.

Known issues and limitations

  • Some options in the Power BI service aren't available in Microsoft Teams. These options include:
    • Notifications.
    • Downloading apps such as Power BI Desktop and Power BI Paginated Report Builder.
    • Sending feedback.
    • Settings such as managing personal storage and accessing the admin portal.
  • Power BI doesn't support the same localized languages that Microsoft Teams does. As a result, you might not see proper localization within a report.
  • The Power BI app for Microsoft Teams is available to Commercial Cloud and US Government Community Cloud (GCC) customers.
  • Search experience is not available in US Government Community Cloud (GCC).

Next steps

More questions? Try asking the Power BI Community.