Microsoft 365 Reports in the admin center - Microsoft Teams apps usage reports

The Microsoft 365 Reports dashboard shows you the activity overview across the products in your organization. It enables you to drill in to individual product level reports to give you more granular insight about the activities within each product. Check out the Reports overview topic. In the Microsoft Teams app usage report, you can gain insights into the Teams apps activity in your organization. This article explains how to access the report and view and interpret the various metrics within the report.

You can use this report to understand who is installing/using apps, and deep dive on a per-app and per-user level.

What's in the report

The Teams app usage report is available in the Microsoft 365 admin center and the data is provided through two separate reports:

App usage - This report helps you answer:

  • How many apps have users in your environment installed?
  • How many apps have at least one active user in your environment?
  • How many apps are being used by platform (Windows, Mac, Web, or mobile)?
  • How many active users and active teams are using the app?

User activity - This report helps you answer:

  • How many users in your environment have installed at least one app?
  • How many users in your environment have used at least one app?
  • How many users are using an app across platforms (Windows, Mac, Web, etc)?
  • How many apps has each user used?

How to get to the Microsoft Teams apps usage report

  1. In the admin center, go to the Reports > Usage page.

  2. From the dashboard homepage, click on the View more button on the Microsoft Teams apps activity card.

    Microsoft Teams app.

Considerations

  • Usage/installs data for a newly published app can take about five days to show up in the report. Data for a given day will show up within 48 hours. For example, data for January 10th should show up in the report by around January 12th.

  • The start date for all installs metrics is October 2021. Only apps installed after that date will be counted.

  • App IDs in this report are the External (manifest) App IDs. For more information on how to tie this ID to an app in the Manage Apps experience in Teams Admin Center, see Manage app setup policies in Microsoft Teams.

  • You can export the report data into an Excel .csv file by selecting the Export link. This exports data for all users/apps and enables you to do simple sorting and filtering for further analysis.

Exploring the report - App usage tab

You can view the App usage in the Teams app usage report by choosing the Apps usage tab.

Teams user activity.

On the top of the report, you will see three charts describing cross-app trends across your organization.

  • Apps installed
  • Apps used
  • Platform

You can filter all charts by the time range picker in the top right.

Microsoft Teams apps usage time filter.

Apps installed

This chart shows you the total number of app installs across your organization up to each date within the selected period. For example – if you select January 28th 2022, the chart will show you the total number of installs from October 2021 up to January 28th 2022.

Microsoft Teams apps installed.

Apps used

This chart shows you the number of apps used across your organization on each date within the selected period. For example – if you select January 28th, the chart will show you the total number of apps used on January 28th.

Microsoft Teams Apps used.

Platform

This chart shows you the number of apps used across your organization by platform for the selected period. Available platforms are Windows, Mac, Mobile (across iOS and Android), and Web.

Microsoft Teams platform.

Apps usage details table

This table shows you per-app view with the following metrics for each app. A subset of the metric columns are included by default, and you can select/edit the column list by clicking on Choose columns in the top right.

Apps usage details.

Metric Definition Included by default?
App ID The external App identifier present in the app manifest. Yes
Last used date The date when that app was last used by anyone in your organization. Yes
Teams using this app The number of distinct Teams teams that have at least one user using this app. Yes
Users using this app The number of distinct users in your organization that are using this app. Yes
Used on Windows This indicates whether that app has been used on Windows by at least one user in your organization. Yes
Used on Mobile This indicates whether that app has been used on Mobile by at least one user in your organization. Yes
Used on Web This indicates whether that app has been used on Web by at least one user in your organization. Yes
Used on Mac The number of ad hoc meetings a user organized during the specified time period. No
App name The Name of this application as present in the app manifest. No
Publisher The publisher of this application as present in the app manifest. This is only available for apps published to the global Store. No

Exploring the report - Teams apps usage user activity tab

You can view the user activity in the Teams app usage report by choosing the User activity tab.

Microsoft Teams user activity.

On the top of the report, you will see three charts describing cross-app trends across your organization.

  • Users who have installed apps
  • User who have used apps
  • Platform

You can filter all charts by the time range picker in the top right.

Microsoft Teams user activity time filter.

Users who have installed apps

This chart shows you the total number of unique users that have installed an app up to each date within the selected period. For example – if you select January 28th 2022 the chart will show you the total number of users from October 2021 up to January 28th 2022.

Microsoft Teams apps Users who have installed apps chart.

User who have used apps

This chart shows you the number of unique users that have used any app on each date within the selected period. For example – if you select January 28th, the chart will show you the total number of users on January 28th.

Microsoft Teams apps Users who have used apps chart.

Platform

This chart shows you the number of apps used across your organization by platform for the selected period. Available platforms are Windows, Mac, Mobile (across iOS and Android), and Web.

Microsoft Teams usage user activity platform.

User activity details table

This table shows you per-user view with the following metrics for each app. A subset of the metric columns are included by default, and you can select/edit the column list by clicking on Choose columns in the top right.

User activity details.

Metric Definition Included by default?
User name The User name for a unique user. Value is concealed by default. Yes
Apps installed The number of unique apps (across Store and custom) that the user has installed. Yes
Apps used The number of unique apps (across Store and custom) that the user has opened and/or used. Yes
Apps used in a Team The number of unique apps (across Store and custom) that the user has opened and/or used in a Teams Team. Yes
Used on Windows This indicates whether that user has used any app on Windows. Yes
Used on Mobile This indicates whether that user has used any app on Mobile (iOS or Android). Yes
Used on Web This indicates whether that user has used any app on Web. Yes
Used on Mac This indicates whether that user has used any app on Mac. No

Managing apps in the Teams Admin Center

For more information about how to manage your Teams apps, please refer to About apps in Microsoft Teams.

To link an app in this report to the Manage Apps experience in Teams Admin Center, you can use the following:

  • App Name
  • External App ID

External App IDs are equivalent to the ID in the Manage apps page for Store apps. For custom apps, to view External App ID in the Manage Apps page, follow the instructions on Manage apps setup policies in Microsoft Teams to add the column in the column settings. You can also view it on the app details page for a custom app