A Buuk help center is structured in three levels: collections, sections, and folders. Collections are the top-level surfaces readers see as tabs — Documentation, FAQ, Guides, API Reference, and Changelog. Inside each collection, sections are the top-level groups, folders nest under a section for related pages, and articles are the individual pages readers open.
This structure controls both the editor tree in the dashboard and the public navigation on your help center.
How the hierarchy works
- Sections group articles by topic inside a collection — for example, "Writing" or "Help center."
- Folders nest under a section when a topic has several related pages. On this site, Editor is a folder under Writing.
- Articles are the leaf pages readers actually open.
Position in the editor tree is what the public nav uses, so how you arrange sections, folders, and articles in the dashboard is exactly how customers will see them.
Create and organize a section
- Open the dashboard and go to the collection you want to organize — Articles, FAQ, or Guides.
- Use the option to create a section within that collection.
- Name the section to match the topic it covers.
- Drag the section up or down in the tree to set its position in the public navigation.
Nest a folder under a section
- Inside a section, create a folder when you have several related pages to group — for example, a set of editor-specific how-tos under a broader "Writing" section.
- Drag articles into the folder to nest them.
- Folders are collapsible in the sidebar, which keeps a long navigation scannable for readers.
- Reorder folders and the articles inside them the same way you reorder sections — drag to set position.
Set visibility and access
Sections can be restricted so only certain readers see them:
- Set a section to private so only workspace members can view it.
- Attach access groups to a section for gated reader content, using passphrase or JWT reader authentication depending on how your help center is configured.
Per-article visibility works independently of section visibility. Individual articles can be set to everywhere, unlisted, hidden, or AI-only — useful when a page should ground AI answers but stay out of the public nav.
Slugs and redirects
Article slugs become the public path under your help center, for example /help/your-slug/article-name. If you rename the workspace slug, Buuk keeps a redirect from the old /help/old-slug URL so existing links and bookmarks continue to resolve.
Clean up empty folders and unused pages
Empty folders still appear in the editor tree even after every article inside has been moved or deleted. Check the tree periodically and remove folders that no longer hold content.
Leftover template pages — drafts created when a collection was first set up — should be archived rather than left in place. Archived pages do not show in the public nav, which keeps the navigation focused on content readers actually need.
Troubleshooting
A section or folder isn't showing on the public site.
Confirm the section isn't set to private without the reader having access, and confirm at least one article inside it is published. Empty sections and folders with only draft articles won't have visible content for readers.
An old link to an article returns a 404.
Check whether the article's slug changed. Article-level slug changes don't automatically redirect the way workspace slug changes do — update any external links to match the current slug.
The navigation order doesn't match what I set.
Reordering is drag-and-drop in the editor tree. If a section or folder appears out of place, re-open the tree and drag it to the correct position; the public nav reflects saved position, not creation order.
FAQ
What's the difference between a collection and a section?
A collection is a top-level surface like Documentation, FAQ, Guides, API Reference, or Changelog, enabled per workspace under Customise → site profile. A section is a group inside one of those collections.
Can a folder contain another folder?
Folders nest under a section for related articles. If a topic keeps growing, consider splitting it into a new section rather than nesting deeply, so the public navigation stays easy to scan.
Do private sections affect Ask AI and search?
Per-article visibility settings, including AI-only and hidden, determine what's used to ground Ask AI answers and what appears in search results, independent of section-level access rules.
Will moving an article between sections break its link?
The article's slug is what forms the public path. Moving an article between sections or folders in the tree does not change its slug, so existing links keep working unless the slug itself is edited.