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.
Note: Open the Applications manager, select an app, and look for 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
| Metric | What it measures |
Page views | Total number of times any page in the app was loaded by a user. |
Sessions | Distinct user sessions — a session groups consecutive activity by the same user. |
Active users | Unique users who interacted with the app in the chosen period. |
Engagement over time | A time-series view of activity, showing growth or decline across the period. |
Screen-level breakdown | Which pages are visited most, where users spend time, and where they drop off. |
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.
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: Flip the Enable Analytics switch. The panel describes this as gaining insight into user behavior, monitoring engagement across screens, and identifying drop-off points.
Save and publish: Save the settings and publish the app. Data collection begins immediately for all 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 platform exposes the same analytics data in two places, serving different workflows:
| Surface | Where | Best for |
| Insights tab | App detail page in the Applications manager | Reviewing adoption and usage data without opening the builder — suitable for product owners and stakeholders. |
| Analytics view | Builder left nav → Analytics | Examining usage while actively editing — charts are clickable and navigate directly to the block, data source, or function they measure. |
Both surfaces show the same underlying data for the same app. The in-builder Analytics view adds interactive navigation — clicking a data point jumps you to the relevant block or resource. See App Analytics for a full description of the builder view.
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). An admin may need to enable this at the workspace level before the option appears. 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.
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 — the in-builder analytics view, custom events, and clicking chart data points to navigate to blocks.
App Settings & Privacy — where analytics is enabled, alongside CSP and password policy.