What Is the Insights Tab?
Insights is the usage-analytics tab on an app's detail page. It shows how the app is being used — visits, active sessions, and user activity over a selected time range — as a ready-made dashboard, so you can gauge adoption and engagement for any app you own.
The tab appears only after app analytics is enabled for that app. Until analytics is turned on, there is no data to display and the Insights tab is not shown at all.
To open it, go to the Applications manager, select an app and click the Insights tab in the app's tab bar. If the tab is missing, analytics has not been enabled; see Enabling Analytics below.
What the Insights Dashboard Shows
The Insights dashboard presents usage metrics for the app over a configurable time range. The charts and figures are produced by the platform's analytics engine rather than something you configure yourself — they reflect real usage measured from the moment analytics was switched on.
Key Metrics
The Insights tab has three sub-tabs: Engagement, Performance and Events. The Engagement tab shows the following tiles and charts.
Tile or chart | What it shows |
|---|---|
| Unique users who used the app in the chosen period. |
| Average number of users active per day. |
| Average number of users active per month. |
| Average time each user spends in the app. |
| Daily and monthly active users over time. |
| How the app is used over the selected period. |
| Which pages are visited most. |
The Performance tab shows how the app performs, and the Events tab lists custom events (see Custom Events below).
Warning: Analytics collection starts from the moment it is switched on — there is no retroactive data. If your app launched before analytics was enabled, usage from that period is not included in the charts.
Custom Events
Custom events you fire with the Send Custom Event action appear in the Events view of the Insights tab, one row per event name. The list is built from the events that were actually sent, so an event that has never fired has no row yet. Event attributes are recorded with each event but are not charted. Renaming an event starts a new row; the history under the old name is not merged.
Enabling Analytics
Analytics is off by default for every new app. You must turn it on in the app's settings before the Insights tab appears and before any usage data is collected.
Open the builder for your app: From the Applications manager, click the app and then open the builder.
Navigate to Settings → Advanced Settings → Analytics: In the builder's left nav, select Settings, then find Analytics under Advanced Settings.
Toggle Enable Analytics on: Turn on the Enable Analytics switch under User Activity Insights. The builder saves the change automatically.
Publish the app again: Data collection begins for new user sessions in the published app.
Open the Insights tab: Return to the app's detail page in the Applications manager. The Insights tab is now visible. Allow some time for usage data to appear — the dashboard will be empty until real users interact with the published app.
Insights Tab vs. In-Builder Analytics View
The Insights tab and the builder's Analytics item show different things:
Surface | Where | What it shows |
|---|---|---|
Insights tab | App detail page in the Applications manager | Usage data for the published app, including custom events. Appears only when Enable Analytics is on. |
Analytics view (App health) | Builder left nav → Analytics | A best-practices report on how the app is built: health score, page scores and checks. Items are clickable and take you to the block, data source, or function they describe. Does not need Enable Analytics. |
Use the Insights tab to see how the app is used, and App health to see how well it is built. See App Analytics for a full description of the builder view and the enable steps.
Comparing Apps Across the Workspace
The Insights tab is scoped to a single app. To compare multiple apps — spotting which are growing, which are stalling, and which are going unused — use the workspace-wide analytics dashboard available to administrators. The per-app Insights tab gives you depth on one app; workspace analytics gives you breadth across all of them.
Troubleshooting
Insights tab is not visible
Warning: The Insights tab only appears when app analytics is enabled for that application. If the tab is absent, analytics has not been switched on.
Fix: Confirm analytics is turned on in the app's builder settings (Settings → Advanced Settings → Analytics → Enable Analytics). You need edit access to the app to change its settings. After enabling, republish the app and refresh the app detail page.
Dashboard shows no data
If the Insights tab is visible but charts show zero activity:
Verify the app has been published — analytics only collects data from the published app, not from builder preview sessions.
Confirm that real users have accessed the published app since analytics was enabled. Preview sessions by the builder author are not counted.
Check that the selected time range covers the period since analytics was enabled.
On a public app, note that signed-out visitors are not tracked — only authenticated user sessions appear in the analytics data.
On a mobile app set to Public, no analytics are collected at all, even for signed-in users. If you need Insights, set the app's Access level to Private (app Settings tab → Privacy Settings).
Scenario — App launched before analytics was enabled
An app was live for three months before analytics was turned on. The Insights dashboard shows data only from the date analytics was enabled onward. The three months of prior usage are not available. To capture historical data going forward, enable analytics as early as possible in the app lifecycle — ideally before or at launch.
Related Pages
App Analytics — enabling analytics, custom events, and the in-builder App health view.
Send Custom Event — the action that fires a custom event.
App Settings & Privacy — where analytics is enabled, alongside CSP and password policy.