App usage

View your app's usage across platforms, app store versions, and time in the App usage tab of EAS Insights.

App usage is in preview and subject to breaking changes. While in preview, it is free to use.

The App usage tab offers a view into a project's performance, usage, and reach. It allows you to see the state of your app, providing information about usage across platforms, app store versions, and timeframes.

Integration with EAS Update

If you're already using EAS Update, you get certain high-level usage insights without any additional client-side changes. This works by aggregating the update-check requests your app already makes into a limited Insights view of usage over time and by platform.

Use the expo-insights library

Developers can add the expo-insights library to their projects and gain more precise usage metrics (than those provided by just aggregating update requests) and additional breakdowns by app store version. Currently, the library is limited to sending client events only pertaining to cold starts of the app, but in the future, expo-insights will expand to offer new types of events and payloads, to support more advanced functionality.

Installation

To use expo-insights, make sure your app is linked to your EAS project in app config by running eas init, then install the library.

After installing the library, create a build either with EAS or locally. The library automatically sends events to EAS Insights when the app launches.

View insights

To view usage data of your app, open your project in the EAS dashboard, select Insights from the navigation menu, and then select the App usage tab.