04-folders
Folders
Folders help you organise your documents into a hierarchical structure. You can nest folders inside other folders to create any structure that fits your needs.
The Folder Tree
Your folders appear in the sidebar under the "Library" section, displayed as an expandable tree. Subfolders are indented under their parent folders.
[screenshot: sidebar folder tree with nested folders]
Creating a Folder
There are two ways to create a folder:
Top-Level Folder
Click the New folder button at the bottom of the folder tree in the sidebar. A text field appears — type the folder name and click Create.
[screenshot: new folder input at bottom of folder tree]
Subfolder
Hover over any existing folder in the sidebar to reveal action buttons. Click the + button to create a subfolder. A text field appears indented under the parent folder — type the name and click Create.
[screenshot: subfolder creation input indented under parent folder]
Viewing a Folder
Click any folder in the sidebar to view its contents. The folder view shows:
- A breadcrumb trail at the top showing the full path (Documents / Parent / Current Folder)
- A New button to create a document directly inside this folder
- A list of documents in this folder
[screenshot: folder view with breadcrumb and document list]
Renaming a Folder
Hover over a folder in the sidebar to reveal action buttons. Click the pencil icon to rename it. The folder name becomes an editable text field — make your changes and click Save.
[screenshot: folder rename inline form]
Deleting a Folder
Hover over a folder in the sidebar and click the trash icon. A confirmation dialog will appear:
"Delete 'Folder Name' and all its contents? Documents inside will be moved to trash."
Confirm to delete the folder. Any documents inside the folder will be moved to the trash, where they can be restored.
Folders and Public URLs
When you publish a document that's inside a folder, the folder path becomes part of the public URL. For example:
- Document "getting-started" in folder "tutorials" →
/u/yourname/tutorials/getting-started - Document "laravel" in folder "tutorials/frameworks" →
/u/yourname/tutorials/frameworks/laravel
This means your folder structure directly maps to the URL structure of your public profile, making it easy to create well-organised public content.