Folders
Folders are the primary way to organise test cases within a project. They form a hierarchical tree in the left panel, 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), move an entire drawer to a different position (drag-and-drop move), or photocopy a drawer and all its contents into another location (drag-and-drop copy). Every test case lives in exactly one folder.
Creating a folder
- Click the New Folder button above the folder tree.
- Enter a name for the folder.
- Optionally choose a parent folder (defaults to root level).
- Optionally add a description.
- Click Create.
Folder names do not need to be unique. You can have two folders named Login at different tree levels without conflict.
Creating a subfolder
Right-click a folder (or click its three-dot menu) and select Add Subfolder. The parent is pre-filled with the selected folder. Fill in a name and click Create.
Editing a folder
Open the three-dot menu on any folder and select Edit. You can change the folder’s name and description.
Folder icons
Each folder can have a custom icon to make it visually distinct in the tree. Choose from:
- Emoji — pick any emoji from the picker.
- Icon — select from the built-in icon library with a custom colour.
- Upload — upload a small image to use as the folder icon.
Moving folders
Drag a folder in the tree and drop it in a new position. Four drop positions are supported:
| Drop position | What happens |
|---|---|
| Before | Places the folder above the target as a sibling. |
| Inside | Nests the folder as a child of the target. |
| After | Places the folder below the target as a sibling. |
| Root | Moves the folder to the top level of the tree. |
Moving a folder moves everything inside it. All subfolders and test cases within the moved folder travel with it. This action cannot be undone from the UI.
Copying folders
Hold the modifier key while dragging to copy a folder instead of moving it. A confirmation dialog appears when the source tree is large (more than 20 subfolders or 100 test cases) to prevent accidental bulk duplication.
All subfolders and test cases within the copied folder are duplicated with new IDs. The originals remain unchanged.
Deleting a folder
Open the three-dot menu on a folder and select Delete. Before confirming, an impact analysis shows:
- Number of subfolders that will be removed.
- Number of test cases that will be deleted.
- Number of active test runs that reference cases in this folder.
You must acknowledge the impact on cases and runs before deletion proceeds.
Deletion is permanent. All subfolders, test cases, their field values, attachments, comments, and history are permanently removed. Cases referenced by active test runs are removed from those runs. This cannot be undone.
Folder tree interactions
- Click a folder to filter the centre table to cases in that folder and its subfolders.
- Expand/Collapse individual folders by clicking the arrow, or use the Expand All / Collapse All buttons.
- The folder panel is resizable — drag the divider to adjust width.
- Each folder shows a case count next to its name.