This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

View your app's usage across platforms, app store versions, and time in the App usage tab of Expo 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 Expo Update

If you're already using Expo 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 Expo Services project in app config by running eas init, then install the library.

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

View insights

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