Configuring Site Navigation
Your documentation navigation is built from the pages and folders in your docs tree. By structuring this tree thoughtfully, you control the order readers encounter your content and how easily they move between topics on your published site.
How It Works
•The docs editor displays your pages and folders in a navigable tree that mirrors the navigation readers see on your live site.
•You can create new pages and folders, rename them, and delete items you no longer need.
•Drag-and-drop reordering lets you change the sequence of pages and folders to match your preferred reading flow.
•Nesting pages inside folders creates grouped sections, giving your navigation a clear hierarchy.
•Changes to the tree are reflected in the live preview and on your public site once published.
Steps
1.Open the documentation editor from your dashboard to view the current page and folder tree.
2.Create a new folder to group related topics, or add a new page where you want fresh content to live.
3.Rename pages and folders so their titles clearly describe what readers will find inside.
4.Drag items up or down, or into a folder, to set the order and nesting of your navigation.
5.Delete any outdated pages or folders to keep the navigation clean and focused.
6.Open the live preview to confirm the navigation reads the way you intended, then publish your changes.
Navigation Actions
Action | What It Does | Best Used For |
|---|---|---|
Create page | Adds a new content page to the tree | Individual topics or articles |
Create folder | Adds a grouping container for pages | Sections with multiple related pages |
Rename | Updates the title shown in navigation | Clarifying labels for readers |
Drag-and-drop | Reorders or nests items | Setting reading sequence and hierarchy |
Delete | Removes a page or folder from the tree | Clearing outdated content |
Tips
•Order your most important pages near the top of the tree so readers find essential information first.
•Group related pages under clearly named folders to keep deep topics tidy and easy to scan.
•Use short, descriptive titles since they double as navigation labels on your live site.
Always check the live preview before publishing to make sure your navigation flows logically for first-time readers.
Deleting a folder may remove the pages nested inside it, so move any content you want to keep before deleting.
Troubleshooting
•If your navigation changes don't appear on the live site, confirm you published after editing the tree.
•If drag-and-drop doesn't drop an item where expected, release it directly over the target folder or position and try again.
•If a renamed page still shows the old title in preview, refresh the preview to load the latest structure.
•If a page seems missing, check whether it was accidentally nested inside a collapsed folder in the tree.
Related topics: Edit documentation pages, Preview and publish the site, Edit the home page.