Folders

Folders are the primary way to organise test cases within a project. They form a hierarchy you navigate through the scope bar at the top of the page, letting you group cases by feature area, module, sprint, or any structure that matches your workflow.

Think of it as a filing cabinet

Folders work like a filing cabinet: you can nest drawers inside drawers (subfolders) and move an entire drawer somewhere else, and everything inside travels with it. Every test case lives in exactly one folder — but you do not have to choose one, because a case you do not file goes to Unfiled.

Unfiled

Unfiled is a built-in folder the server owns. When you create a case without picking a folder, the server files it there rather than turning you away — so a brand-new project with no folders at all can still have its first case written in it. Cases move out of Unfiled exactly like cases in any other folder.

Unfiled appears only once it is needed. It is created the first time a case in that project is created without a folder. A project whose cases have all been filed has no Unfiled folder at all, and nothing shows one.

Because it is server-owned, Unfiled is not an ordinary folder:

• It cannot be renamed, moved, or deleted, and it cannot contain subfolders. Attempting any of these is refused — Unfiled is a built-in folder and can’t be renamed.
• It is not offered as a destination in the bulk Move to folder… palette, and it does not appear in the scope bar’s folder jumper, in Manage folders, or in the command palette. You cannot scope the list to it.
• It is offered on a single case’s Folder picker, which is how you put a case back into it. See the Folder picker.
• Where it does show — the Folder column, and folder-grouped views — it is drawn muted, to read as “not filed” rather than as a folder someone named.

A folder you name “Unfiled” yourself is an ordinary folder. The built-in one is identified by a flag, never by its name, so your own folder of that name renames, moves, deletes, and nests like any other.

Navigating folders

There is no folder-tree sidebar. Instead, the scope bar shows a breadcrumb of where you are — starting at All cases — and gives you two ways to move around:

• Click a crumb to jump back up to that level.
• Click the switcher pill to open the folder jumper, a searchable list of folders. Each row shows the number of cases in that folder and everything beneath it.

Changing folder is a filter, not a page load — the folder lives in the URL, so a scoped view is shareable.

Folder scope and grouping are different things. The scope bar decides which cases you are looking at. The scope bar’s Group by folder toggle instead arranges the cases you can already see into per-folder groups, and pairs with Nested folders in the Display popover to indent subfolders under their parents.

By default a folder shows only its own cases. Add the Include subfolders filter to widen the scope to everything beneath it.

Creating a folder

1. Open the folder menu in the scope bar.
2. Choose New folder at the root, or New subfolder on an existing folder — the parent is whichever folder’s menu you opened.
3. Enter a name and click Create folder.

Folder names do not need to be unique. You can have two folders named Login at different levels without conflict.

Renaming a folder

Open the folder’s menu and choose Rename. A folder has a name; there is no separate description or custom folder icon on this page.

Moving folders

There are two ways to move a folder, and neither is the only path — every drag target has a keyboard-operable equivalent.

From the folder menu

Choose Move to… and pick a new parent from the folder picker.

From Manage folders

Choose Manage folders… to open a modal listing the whole hierarchy, where you can drag rows:

Each row in the modal also keeps its own … menu with Move to…, so you never have to drag.

Moving a folder moves everything inside it. All subfolders and test cases within the moved folder travel with it.

You cannot drag a test case into a folder. To move cases, select them and use Move to folder… in the bulk actions palette, or change the Folder property on a single case. Dragging in Manage folders moves folders, never cases.

Deleting a folder

Open the folder’s menu and choose Delete. The confirmation names the folder and spells out what goes with it — how many subfolders and how many test cases are inside — and when cases are involved the confirm button counts them, for example Delete 42 cases.

Deletion is permanent. The folder, its subfolders, and every test case inside are removed, and those cases are taken out of any active runs. This cannot be undone — there is no trash, no restore, and no undo for a folder or case deletion.

Permissions

Seeing the scope bar and jumper needs View folders. Creating, renaming, moving, and deleting folders all need Manage folders.