Report templates: the Reports tab

Ship ready-made reports with your module, on its own Reports tab: pages people read, filter, print and save as PDF.

Copy page for AIUpdated November 8, 2026

A dashboard is for exploring. A report is for reading and handing on: a titled page laid out like paper, with a summary line, grouped tables and totals, that prints cleanly. Every module has a Reports tab, added by the platform. Your job is to fill it with a few good ready-made reports, called templates.

The Reports tab comes free

You don't build a Reports page or add a menu item. The platform adds Reports at the end of your module's menu, with its own permission (Open … Reports tab) that Admin, Operator and Viewer roles get by default. The tab lists:

  • the templates your module ships, and
  • the saved reports people built on your module's data, from a template or by asking the agent.

A report template, step by step

A template answers one question your users ask often, such as "which vehicles had defects this month?"

  1. Name and describe it. Driver's vehicle inspection: each inspection of one vehicle for a period, defects first.
  2. Say what the reader picks. For example, which vehicle. The choices come from your module's own list.
  3. Say where the data comes from. Your module's read-only actions, or your datasets.
  4. Lay out the page. Summary counts, tables grouped by a field, charts, timelines, pivot tables, photo galleries.
  5. Add filters readers can change above the page: a date range, a pick-list or a text search. One template with a date filter beats twelve monthly ones.

The data is fetched as the person opening the report, every time. Two people opening the same report each see only what their own role allows, and the numbers are always current.

Saved reports and who can see them

On the Reports tab, a person clicks + From a template, fills in what it asks for and clicks Create report. It's saved as their own report.

WhoCan
The owner and Workspace AdminsOpen, change, share and delete it
People it's shared withOpen and print it (VIEW ONLY)

Some reports are for fewer people, such as payroll. Give the template its own report permission, and only roles holding it can open it; its card shows LIMITED. The owner or a Workspace Admin can change this with Who can open it.

Sharing and scheduling a report

  • Share with everyone in the report's toolbar makes it visible to the whole workspace. Each person still sees only their own data.
  • Named people: share by asking the agent, Claude with the connector, or the command line. The screen doesn't have a picker for that yet.
  • Print / Save as PDF prints exactly what's on screen, filters listed under the title.
  • Scheduled reports by email are not available yet. They're planned. For now, ask people to open the report, or send a notification linking to it.

Ask the Module Builder

For developers

A template is a skill package ai/skills/report-<name>/ with a SKILL.md and a report.json:

json
{"name": "Open jobs by crew", "permission": "JOBS.REPORT_OPEN",
 "spec": {"title": "Open jobs by crew",
   "sources": {"jobs": {"action": {"module_code": "JOBS", "name": "list_jobs"}, "rows": "data"}},
   "blocks": [{"type": "table", "source": "jobs",
               "columns": [{"key": "name", "label": "Job"}]}]}}

Check it with platform reports templates --module JOBS.

Good to know

  • There's no switch to remove the tab. You can rename it or move it in your menu.
  • A report never shows more than a person could already see. Permissions decide the data, not the report.
  • Want charts to explore instead? See Charts, maps and 3D.

Can't find what you need? Contact support.