docs-mintlify/docs/organize-content/folders.mdx
As your team creates workbooks, dashboards, and explorations, folders help you keep content organized and easy to find. Folders provide a hierarchical structure that mirrors how your team thinks about its data — by team, project, domain, or any other grouping that makes sense.
To create a folder:
You can also create folders inside existing folders to build a nested hierarchy. Open the parent folder first, then follow the same steps.
{/* Screenshot: Workspace page with the "New folder" button visible in the toolbar and the folder name dialog open, showing the name input field and Create button. */}
<Info>Folder names must be unique within the same parent folder.
</Info>Folders support up to 10 levels of nesting, allowing you to build detailed hierarchies. For example:
Workspace (root)
└── Marketing
└── Campaigns
└── Q1 2025
└── Email Performance
Each level provides further categorization while keeping content accessible through the folder tree.
Folders can contain the following content types:
Content that is not placed in a folder appears at the root level of your workspace.
{/* Screenshot: Workspace page showing a folder containing a mix of content types — at least one workbook, one dashboard, and one exploration visible in the list. */}
To move a workbook, dashboard, or exploration into a folder, open the item's action menu and select Move. Choose the target folder from the folder picker and confirm. You can also move items to the root level by selecting the workspace root as the destination.
{/* Screenshot: The folder picker dialog that appears after clicking "Move" on a workbook, showing the folder tree with nested folders to choose from and a confirm button. */}
To rename a folder:
{/* Screenshot: A folder's action menu (three-dot / context menu) open, showing options including Rename, Move, Share, and Delete. */}
<Info>The new name must be unique within the same parent folder.
</Info>You can rearrange your folder hierarchy by moving folders to a different parent:
A folder cannot be moved into one of its own subfolders.
</Warning>To delete a folder:
A folder can only be deleted if it contains no subfolders. Move or delete any subfolders first.
</Warning>Folder access is controlled through three permission levels:
| Level | Allows |
|---|---|
| Can view | View the folder and its contents |
| Can edit | Rename the folder, move content into it, and create subfolders |
| Full access | Full control including moving and deleting the folder, and managing folder permissions |
The creator of a folder automatically receives Full access.
To learn how to share folders with users, groups, or your entire organization — and how permissions are inherited by content inside folders — see Share content.