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.

With the Power BI app in Microsoft Teams, 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.

Also, 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 in Teams.

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

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. For details, see public preview in Outlook and Office.

Requirements

Ensure the following elements are in place to install the Power BI app in Microsoft Teams:

• Power BI app is enabled in the Teams Admin center apps list.
• Your users with a Fabric (Free) license can access personal analytics. They can use the built-in Teams analytics report and create reports in their My workspace.
• Your users with Fabric (Free) licenses can also access content that's shared with them from a workspace that's part of a Power BI Premium capacity (P SKU) or Fabric F64 or greater capacity.
• Your users with a Power BI Pro or Premium Per User (PPU) license can share content with others or build content in workspaces.
• Users have signed in within the Power BI app for Teams or the Power BI service and activated 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, and then search for and select Power BI.

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

Sign in to Power BI

The first time you open the Power BI app in Teams, you need to sign in to Power BI.

• If multifactor authentication (MFA) for Power BI is configured for your account, you'll see a message requesting additional permissions.

  

  Select Continue, and then provide the next factor of authentication (as configured by your organization).

• If MFA for Power BI isn't configured for your account, you'll be prompted to go through the regular Power BI sign in process.

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.

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

Interact with your content in Microsoft Teams

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

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

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

The Power BI app in Microsoft Teams helps you multi-task by remembering where you navigated to for one hour. When you leave the app and return within one hour, the app automatically takes you back to where you were working by navigating to:

• Items you visited, such as the report page you were on and the filters you applied.
• Places you visited, such as Home, Create, Data hub, Workspaces, and so on.

When using the Power BI app in Microsoft Teams Desktop, you can use the Microsoft Teams back button to navigate back within the Power BI app. When using the app in Microsoft Teams in a web browser, use the browser back button.

Differences in interactions

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

• When you look at a dashboard or report, you don't see the Power BI navigation pane. To access the navigation pane, select Close to go back to Home or the workspace.

  

• To open the report in the Power BI service instead of viewing it in Microsoft Teams, select Open this on the web.

  

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, enter @Power BI.

   Note

   Be sure to include the space between Power and BI.

   

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

   

3. Select Open.

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

4. If you haven't installed the Power BI app yet, Teams asks you to add it.

   

Increase Power BI app adoption in Teams

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

Are you a leader in your organization? You can encourage individuals and teams to use 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 about the options for broad and targeted rollout 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 is installed automatically in some circumstances. See Install the Power BI app for Teams automatically for details. To encourage the users in your organization to use the app more regularly, pin 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. After November 1, 2021, installation occurs automatically for users who visit the Power BI service and meet the criteria.

Power BI end users might see a notification in the Power BI service notification pane that says 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 isn't available in US GCC.

• To automatically take you back when navigating back to the app, your navigation history is saved approximately every 15 seconds. The history is stored locally on your computer or in your web browser window. If you navigate to a place and filter, then quickly switch to another part of Teams, such as to Chat, Calendar, or Teams, your navigation may not be captured. If you change computers or start a new browser window, the history isn't available.

Related content

• Enable remote work in Microsoft Teams with Power BI

More questions? Try asking the Power BI Community.