Monitor app and user analytics
Learn how to access usage and adoption trends across your Retool organization.
As more users build and use Retool apps within your organization, it’s helpful to understand adoption patterns to better make decisions about your use of Retool. If you’re self-hosting Retool, you might run multiple instances, and seeing which users are using which apps can be difficult.
Retool provides a number of usage analytics for you to view that provide detailed information about users and app usage. For self-hosted organizations, usage analytics data is aggregated across all deployments that you have.
View usage analytics
Admin users can view usage analytics for your organization by navigating to Settings > Usage Analytics.
Usage analytics are only available to admins by default. Admins can grant access to non-admin users using permission groups. Navigate to your permission group and under Additional > Settings page visibility, select View usage analytics. Users in this permission group can view organization-wide Retool usage.
- Users
- Apps
Active users
The Users tab contains analytics for all users with access to your organization. This is segmented based on the following types:
| Type | Description |
|---|---|
| Total active users | Total number of all users in Retool in the previous 30-day window up to the selected end date. |
| Standard users | Total number of distinct standard users in the previous 30-day window up to the selected end date. |
| Internal end users | Total number of distinct internal end users in the previous 30-day window up to the selected end date. |
| External end users | Total number of distinct external users in the previous 30-day window up to the selected end date. |
You can hover the cursor over each data point in the chart to view complete details for usage.
Users details
The Users details section provides more details about users. You can search the table to filter the results. Select a user in the table to view more details about their app usage over the specified time period.
Active apps
The Apps tab contains analytics for all app usage across the organization. This is segmented based on the following types:
| Type | Description |
|---|---|
| Total active apps | Total number of distinct apps viewed at least once in the previous 30-day window up to the selected end date. |
| Total app saves | Total number of app views across all apps during the selected time period. |
| Total app views | Total number of app saves across all apps during the selected time period. |
You can hover the cursor over each data point in the chart to view complete details for usage.
Apps details
The Apps details section provides more details about app usage. You can search the table to filter the results. Select an app in the table to view more details about its usage over the specified time period.
Enable usage analytics for self-hosted Retool
Self-hosted organizations can enable Usage Analytics by setting the USAGE_API_TOKEN environment variable. This environment variable is a manually granted Usage Analytics access token to ensure security. To obtain this token, contact your Retool account manager.
If you self-host Retool, you might deploy multiple instances to isolate your production and non-production environments. Usage Analytics automatically gathers user and app usage (and other sensitive data) across all of your instances. Retool recommends enabling Usage Analytics on the instance with the most restrictions to keep data secure. Only admins of that instance will have the ability to view usage in Settings > Usage Analytics by default.
Retool assumes emails uniquely identify users. If a user is accessing multiple Retool instances, they must use the same email on each instance to avoid being counted multiple times in active-user counts. This also means that Retool expects to see a temporary spike in usage for an organization undergoing a domain migration.