> For the complete documentation index, see [llms.txt](https://help.tahua.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.tahua.io/product-news/2026/june/data_report_folders.md).

# Data Report Folders

## Overview

Data Report Folders allow admins to organise their Data Reports into named groups, displayed as collapsible accordions on the Reports index page — similar to how Milestone Batches display their milestones.

## How It Works

### Creating a Folder

Click **New Folder** on the Reports index page. Give the folder a name and choose a visibility level (see below). Folders are created by the current admin and can be edited by any admin who can see the folder.

### Visibility Levels

Each folder has one of three visibility settings:

| Setting                   | Who can see it                                            |
| ------------------------- | --------------------------------------------------------- |
| **Private**               | Only the admin who created it                             |
| **`<Organisation name>`** | All admins in the organisation                            |
| **Restricted**            | Only admins who are members of the specified Admin Groups |

The visibility badge is shown next to the folder name on the Reports index. For restricted folders with a single group, the group name is shown; for multiple groups, a "Restricted" link opens a modal listing all groups.

### Assigning Reports to Folders

Reports can be placed in a folder in two ways:

1. **From the Reports index**: Click the dropdown arrow on any report row and select **Assign to Folder**. A modal appears with a list of available folders; select one (or "No Folder" to unfile the report) and save.
2. **From the Report edit page**: Click the **Assign to Folder** button to open the same modal.

Each report belongs to at most one folder.

### Access Inheritance

If a folder is not visible to an admin, reports inside that folder are also hidden from them. Reports with no folder remain visible to all admins regardless of folder visibility rules.

### Accordion Display

On the Reports index, folders appear above unfiled reports as collapsible accordion rows. Click the chevron or folder row to expand/collapse and see the reports inside. Unfiled reports continue to be listed below all folders in the same flat style as before.

## Future Considerations

* **Data Access Rules for editing folders**: Currently any admin who can see a folder can edit its name and visibility. A future iteration will introduce per-folder data access rules to restrict who can edit or delete a specific folder, consistent with the broader Data Policy / Admin Groups permission system.
* **Multiple folders per report**: Currently a report belongs to at most one folder. A future iteration may allow reports to appear in multiple folders if the need arises.
