Folders

Organize files using folder hierarchies within your projects.

What are Folders?

Folders provide hierarchical organization within projects. Use them to group related files and create a clear structure for your documentation.

Creating Folders

Create a Top-Level Folder

1. Navigate to a project
2. Click New Folder
3. Enter folder name
4. Click Create

Create a Subfolder

1. Navigate to a parent folder
2. Click New Folder
3. Enter folder name
4. Click Create

Folders can be nested multiple levels deep.

Managing Folders

Rename a Folder

1. Navigate to the folder
2. Click Folder Settings (⚙️)
3. Enter new name
4. Click Save

Move a Folder

1. Navigate to the folder
2. Click Folder Settings (⚙️)
3. Select Move
4. Choose destination (project or parent folder)
5. Click Move

Moving a folder moves all its contents.

Delete a Folder

1. Navigate to the folder
2. Click Folder Settings (⚙️)
3. Click Delete Folder
4. Confirm deletion

Deleted folders and their contents move to trash for 30 days.

Working with Folder Contents

Add Files to a Folder

When creating a file:

1. Click New File
2. Select the folder from the location picker
3. Create your file

Move existing file:

1. Open the file
2. Click File Settings (⋯)
3. Select Move to Folder
4. Choose destination folder

View Folder Contents

The folder view shows:

• All files in the folder
• Subfolders
• File count
• Last updated timestamp
• Quick actions

Navigate Folder Structure

Use the breadcrumb trail at the top:

Workspace > Project > Parent Folder > Current Folder

Click any breadcrumb to jump to that level.

Folder Structure Examples

API Documentation Structure

API Documentation (project)
├── Getting Started
│   ├── Quickstart.md
│   ├── Authentication.md
│   └── Rate Limits.md
├── Endpoints
│   ├── Users
│   │   ├── Create User.md
│   │   ├── Get User.md
│   │   └── Update User.md
│   └── Posts
│       ├── Create Post.md
│       └── List Posts.md
└── Webhooks
    ├── Overview.md
    └── Events.md

User Guide Structure

User Guides (project)
├── Installation
│   ├── Windows.md
│   ├── macOS.md
│   └── Linux.md
├── Features
│   ├── Core Features
│   └── Advanced Features
└── Troubleshooting
    ├── Common Issues.md
    └── Error Codes.md

Folder Best Practices

Naming Conventions

Use clear, hierarchical names:

• ✅ "Getting Started"
• ✅ "API Reference"
• ✅ "User Guides"
• ❌ "Folder 1"
• ❌ "Misc"
• ❌ "Other"

Optimal Depth

• Keep folder hierarchies 3-4 levels deep maximum
• Too shallow: hard to organize
• Too deep: hard to navigate

When to Use Folders

Use folders when you have:

• More than 10 files in a project
• Clear hierarchical relationships
• Multiple related groups of files

Skip folders if:

• You have fewer than 5 files
• Files don't have clear groupings
• Tags work better for your use case

Folders vs Tags

Use folders for:

• Hierarchical structure
• Physical organization
• Single-parent relationships

Use tags for:

• Cross-cutting concerns
• Multiple categorizations
• Flexible grouping

Often best to use both together.

Folder Operations

Bulk Operations

Select multiple items in a folder to:

• Move them together
• Delete them together
• Apply tags in bulk

Copy Folder Path

1. Navigate to folder
2. Click Folder Settings (⚙️)
3. Click Copy Path

Useful for:

• Linking to folders
• API operations
• Documentation references

Folder Permissions

Currently, permissions are set at the workspace level. Project and folder-level permissions are coming soon.

All workspace members with Editor role can:

• Create folders
• Edit folder names
• Move folders
• Delete folders

Next Steps

• Create and manage files
• Use tags alongside folders
• Track version history
• Restore from trash