Help Center/Admin Operations/How to open "Custom Reports" (Analytics & Reporting) and read it
Admin Operations•Last updated: 2026-10-20•3 min read

How to open "Custom Reports" (Analytics & Reporting) and read it

Saved report definitions: a name and one analytics dataset, with a real Run action and archive.

Have questions or need step-by-step guidance on this topic?

Ask AI Copilot

Step-by-Step Procedure

1

Open the screen

In the admin sidebar open the "Analytics & Reporting" group and click "Custom Reports" (address /admin/analytics/reports). Under the title the line "Data: ..." names where the figures come from: Live: i8_report_definitions; results computed from the analytics datasets.

2

Read the KPI tiles

Tiles: "Saved reports", "Active", "Never run". A tile that says "unavailable" means its source could not be read; it is never shown as zero.

3

Read the table

Columns: Report, Dataset, Period, Last run, Rows at last run, Status, Created. Each row is one saved report.

4

Save, edit, run, archive

See "How to save, run and archive a custom report".

5

Know the limits

There is no scheduler: a report runs only when an administrator clicks "Run report now". If schema section 919 has not been applied the screen says so and offers no buttons.

Expected Operational Outcome

You can read the live data and use the actions this screen really implements.

Troubleshooting & Failure Modes

Symptom: Failed to load analytics/reports: HTTP 403
Likely Cause: The operations API requires an administrator principal.
Resolution: Sign in with an administrator account and click "Retry".
Symptom: A tile or the description says a table "has not been created in this database"
Likely Cause: A database section (918 or 919) has not been applied yet.
Resolution: Ask the platform owner to run npm run db:apply:insight-security. Until then the screen reports it and offers no write buttons.

Was this guide helpful?

Help us refine our platform documentation