Topics group related help articles. Subtopics divide a larger subject into smaller groups. Open your knowledge-base board as a team member to manage both.
Use names customers recognize, such as Billing or Getting started. An overview article can link to the detailed tasks within a topic.
Open the topic's actions menu and edit it. You can change its Title, Description, icon and color. To move it under another topic, change Parent Topic. Choose None (Top Level) to make it a main topic again, then confirm.
On desktop, use the drag handles to reorder topics. Article dragging can require switching to manual sorting; review the confirmation when it appears. Check the resulting order in the customer view.
Open the board's actions menu and choose Manage Structure. Its text box describes your topics and articles:
# Getting started
- Create your account
## Inviting colleagues
- Invite a teammate {Invite users}
A line starting with # is a main topic, and ## is a subtopic. A line starting with - is an article. To rename or move an existing article, keep its old title in braces, as in the example above. Place the line below its intended topic.
Review the structure, then click Update Structure. New articles are created as drafts, so open them, add the instructions and publish them before expecting customers to see them. Check existing articles after moving or renaming them.
In the topic editor, Hide section for users controls its customer visibility. Do not use a hidden topic as your only privacy control for sensitive articles. Use board access or internal articles for the intended audience.
If a topic cannot be deleted because it contains articles or subtopics, move or remove those first and check the deletion message.
Use Markdown sync. Its folders and section metadata define the structure. Make structural changes in those source files so the next sync keeps them.
After reorganizing, open the customer view and find an article through navigation and search. Use article feedback to spot content that readers still find unhelpful.