Folders
Create, rename and delete a workspace's report folders, file reports into them, open a folder's reports from its card, and what the Folders page shows of nested folders and filed reports.
Folders group a workspace's saved cost reports. The Folders page shows every folder as a card that lists the reports filed in it, each a link that opens the report; a subfolder's card names its parent.
Before you start
Creating, renaming, moving and deleting folders needs the Editor team role in a workspace your team can edit. See Access model.
Create a folder
- Open Folders under Reporting and select New folder, or the "Create new folder" card.
- In Create folder, enter a Title.
- Select Create folder.

Rename or move a folder
- Select the pencil on a folder's card.
- In Edit folder, change its Title, or choose a Parent folder to move it under another folder. A folder cannot move under itself or one of its own subfolders. No parent keeps it at the top level.
- Select Save.
Read a folder's reports through a saved filter
A saved filter attached to a folder narrows every report filed in the folder and in its subfolders: each report reads its cost through its own filter and the folder's together, and through the saved filter of every folder above it too. A report outside the folder is untouched.
- Select the pencil on a folder's card.
- In Edit folder, choose the filter under Saved filter. No saved filter detaches the one attached.
- Select Save.
Saved filters are created through the Public API (/v1/saved-filters), and a folder's can also be set there with PUT /v1/folders/{id}/saved-filter. In a workspace that has none yet, Saved filter says "This workspace has no saved filters yet. They are created through the Public API.", and "How folder filters work" under it links to this section. A folder card that carries one names it, as in Reports read through “EU only”.
A report read through a saved filter says so above its chart, one line for each folder that carries one, such as "Read through the saved filter “EU only” of folder “Finance”.", with "How folder filters work" linking here. A draft of the report says the same, because it is read through the same folders. Until the saved filters load, or when they cannot be loaded, the line names the folder alone, as in "Read through a saved filter of folder “Finance”."
File a report into a folder
- Open the report, open More actions and choose Rename and settings.
- In Report settings, choose the folder under Folder. A subfolder is named with the folders above it, as in "Finance / Close". No folder takes the report out of its folder.
- Select Save changes.
Save as a new report asks for a Folder too, starting in the folder of the report you started from. Through the Public API, a report is filed by setting its folderId; an update that leaves folderId out keeps the report where it is, and clearFolder: true takes it out of its folder. See the API reference for the cost report schema.
Delete a folder
Select the bin on a folder's card and confirm with "Delete" in Delete folder. The reports and subfolders in it are kept and move up one level, as the dialog says: into the folder above it, or, for a top-level folder, to the top level, where the report switcher lists its reports without a folder.
How it behaves
- A folder card counts the reports filed in it, and its subfolders when it has any: "2 reports · 1 subfolder". Below the count it links each of those reports; a subfolder's reports are on the subfolder's own card. While the reports load, it says "Loading reports…".
- If the reports cannot be loaded, the page says "Reports could not be loaded" with Retry, and the cards keep their counts.
- Save in Edit folder sends each change on its own, in this order: the title, the move, then the saved filter. If one fails, the rest are not sent, the dialog stays open, and a message names the change that failed, such as "The folder could not be renamed.", or gives the reason the server refused it. Under the fields the dialog then says what already landed, such as "The new title is saved. Save again to retry the rest.", and saving again sends only what is still different.
- If the folders cannot be loaded, Folder says "Folders could not be loaded." with Retry, and saving leaves the report in its folder.
- A deleted saved filter stops applying to the folder's reports at once; the folder no longer names it.
- Until the saved filters load, or when they cannot be loaded, the card of a folder that carries one says "Reports read through a saved filter". When they cannot be loaded, the page says "Saved filters could not be loaded" with Retry, and Saved filter in Edit folder says "Saved filters could not be loaded." with Retry and cannot be changed, so saving keeps the folder's filter.
- A report's filter and the saved filters of the folders above it together hold at most 10 alternatives and 50 conditions in total. A report past that cannot be read until one of them is simplified, and a message names the limit; see Filter with CQL.
- A saved filter on segments combines with a report's own segment condition, and with each alternative of its OR, as the segments both name: a report on a segment reads in a folder filtered to that segment. A report whose segments the folder's saved filter does not name cannot be read, and a message says they have none in common.