Folders
Several list pages in msg.ZenTestAI organize their entries into a folder tree. The behaviour is consistent across all of them: this page is the canonical description; entity-specific chapters link here rather than repeating the details.
Where folders are used
| List page | Folders supported? |
|---|---|
| Test Cases | ✅ |
| Snippets (separate page) | ✅ |
| Macros | ✅ — system macros live in locked folders. |
| Execution Plans (list) | ✅ |
| Scripts, Files, Users, AI Models, External Systems | ❌ — these are flat lists or settings, not trees. |
The "groups" inside an individual execution plan (parallel within / sequential between) are not folders. They are an unrelated concept for execution flow control — see Execution Plans.
What you can do
The same interactions are available wherever folders are supported:
- Navigate — click the chevron to expand or collapse a folder. The number in parentheses next to the name (e.g.
Insurance (12)) is the count of direct children. - Create — use the New folder / Add Folder action in the menubar to create a folder at the root level, or use the Add subfolder action on an existing folder to nest under it.
- Move — drag the handle on a row to:
- reorder items within the same folder,
- move an item into a different folder,
- move a folder under a different parent,
- drop an item or folder onto the Drop to root zone that appears at the bottom of the list during a drag, to bring it back out of all folders.
- Hover actions — folders typically expose Delete, Add subfolder, Add item (test/snippet/macro/plan), Edit, and (where applicable) Play / Run on hover. The exact set depends on the entity (e.g. Play exists on test-case folders, not on macro folders).
- Edit — clicking Edit opens a small form to rename the folder or change its parent.
- Delete — removing a folder removes its contents as well. Items that are still referenced elsewhere will block the delete; see Usage References.
There is no enforced limit on nesting depth — folders can contain folders to whatever depth you find useful.
Locked folders and system items
Some folders carry a small lock icon next to the name. They are managed by the system (or a global / built-in source) and are read-only — you cannot rename them, delete them, or change their contents. The most common case is the folder set holding the global built-in macros. Items inside a locked folder may themselves be locked (read-only), or may be a mix of locked and user-owned.
Picking a folder when creating or editing an entity
Several editors (the test General tab, the macro detail, …) let you assign a folder via a dropdown that mirrors the same tree. Two small icons next to the dropdown usually let you edit the selected folder or create a new folder without leaving the editor — the change is immediately visible in the list page once you save.
A note on naming
The entity used to be called "test group" in some places in the product and in older documentation. The current and correct name is Folder. If you still see "test group" mentioned, treat it as a synonym.