# 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.

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](article:e4966ea4-7f77-4361-9a0b-7f594c97cb8f).
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.

| Who | Can |
|---|---|
| The owner and Workspace Admins | Open, change, share and delete it |
| People it's shared with | Open 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](article:c1fc4f79-8d90-4ce8-96ab-59826e3a3a66) linking to it.

## Ask the Module Builder

> *"Add a report template: open jobs grouped by crew, with a count per crew at the top, a date filter for the last 30 days, landscape. Only managers should see it."*

## 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](article:c126ba3d-e11a-433e-8572-fa73f9420efd).


Source: https://datavisions.ai/docs/creators/platform-services/report-templates-the-reports-tab
