Directories Guide

Working with Directories

Directories organize wiki pages into a tree structure, similar to folders on a file system. Every page lives inside a directory.

Browsing directories

The Home page is the root directory. From there you can navigate into subdirectories. Each directory shows its child directories and pages, with a breadcrumb trail at the top so you can always find your way back.

Creating a directory

1. Navigate to the parent directory
2. Click New Directory
3. Enter a title and an optional Markdown description
4. Set the visibility and editability
5. Click Create Directory

The description is rendered as Markdown on the directory's landing page — useful for explaining what the directory is for.

Editing a directory

Click the Actions button on a directory and select Edit. You can change the title, description, visibility, and editability. Include a change message to explain why you're making the change.

Moving a directory

Click Actions → Move to move a directory to a different parent. All pages and subdirectories inside it move along with it.

Note: Moving a directory updates the URL paths of everything inside it, so existing bookmarks will break. Wiki links (#slug) are not affected since they use slugs, not paths.

Deleting a directory

Click Actions → Delete to delete a directory. A directory can only be deleted if it is empty — it must contain no pages and no subdirectories. Move or delete the contents first.

Sorting pages

When viewing a directory, you can sort its pages using the sort controls above the page list:

• Title — Alphabetical order
• Last edited — Most recently updated first
• Created — Newest first
• Most viewed — Highest view count first

Pinning pages

Editors can pin a page to keep it at the top of the directory listing regardless of the sort order. Hover over a page in the directory listing and click the pin icon to toggle it. Pinned pages show a filled pin icon and always appear above unpinned pages.

Directory history

Directories have full revision history, just like pages. Click Actions → History to see all changes to the directory's metadata (title, description, visibility, editability).

From the history view you can:

• Compare revisions — Select two revisions and click Compare to see a side-by-side diff of what changed
• Revert — Restore the directory's title and description from a previous revision (permissions are not changed)

Subscribing to a directory

Click Actions → Subscribe on any directory to get email notifications whenever any page in that directory or its subdirectories is updated — including pages created in the future.

You can fine-tune notifications by unsubscribing from individual pages or subdirectories. See Mentions & Notifications for full details on how subscriptions work.

Permissions

Directories have their own visibility and permission settings that act as access gates for everything inside them. See Permissions Guide for full details on directory permissions, inheritance, and recursive application.