> ## Documentation Index
> Fetch the complete documentation index at: https://docs.docketqa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Folders

> Organize your tests into a hierarchical folder structure

### Folders

Folders let you organize tests into a hierarchical structure, similar to a file system. As your test suite grows, folders help you group related tests by feature, team, or workflow.

***

### Creating a Folder

To create a folder, navigate to the Tests tab. You can create folders directly from the test list view using the folder creation option.

<img src="https://mintcdn.com/docket-dcd24ade/OeXd-3myu_bNxrDS/images/create_folders.png?fit=max&auto=format&n=OeXd-3myu_bNxrDS&q=85&s=e39fa675df6988a6bb3f5851a9201c73" alt="create_folders.png" width="992" height="382" data-path="images/create_folders.png" />

Folder names can contain letters, numbers, hyphens, underscores, and spaces. You can nest folders up to 10 levels deep.

***

### Navigating Folders

The breadcrumb bar at the top of the test list shows your current location in the folder hierarchy. Click any segment to jump to that level.

<img src="https://mintcdn.com/docket-dcd24ade/OeXd-3myu_bNxrDS/images/folder_breadcrumb.png?fit=max&auto=format&n=OeXd-3myu_bNxrDS&q=85&s=adb2ea28a9ae7bf681b4b98fc18307c5" alt="folder_breadcrumb.png" width="1008" height="630" data-path="images/folder_breadcrumb.png" />

When the path gets long, intermediate segments are collapsed automatically — the root and last two segments always remain visible.

***

### Moving Tests and Folders

You can move tests between folders in two ways:

1. **Drag and drop** — Drag a test or folder row onto another folder or breadcrumb segment
2. **Modify dialog** — Use the three-dot menu on a folder to access Rename, Move, and Expand options

<img src="https://mintcdn.com/docket-dcd24ade/MeCZSp4fCTQ-jM0p/images/move_folders.png?fit=max&auto=format&n=MeCZSp4fCTQ-jM0p&q=85&s=737408f82e830526d2fa82fba7dd544a" alt="move_folders.png" width="980" height="776" data-path="images/move_folders.png" />

The **Expand** option dissolves a folder and moves all its contents up one level — useful for flattening your hierarchy when a folder is no longer needed.

***

### Archiving Folders

To archive a folder, click the three-dot menu and select **Archive**. This archives the folder and all tests inside it, including any subfolders.

Archived items can be restored by an admin.

***

### Folders and Bulk Create

When you [bulk create tests](/essentials/bulk-create) or [generate tests with AI](/essentials/generate-tests), the new tests are placed in the folder you're currently viewing. Navigate to the desired folder before starting a bulk create operation to keep things organized.
