Organize Help Center Topics and Navigation - Article
Summary
Readers should not need to understand your internal organization to find an answer. Topics provide recognizable entry points, while article order and carefully chosen links turn a collection of pages into a usable support service.
Create the structure around real questions and journeys. The Help Center then shows each reader the Topics that contain published guidance available to them.
Use this article to:
- Choose recognizable Topic boundaries
- Create Topics and maintain their visual identity and order
- Use article order, inline links and cross-topic navigation deliberately
Choose a structure people can recognize
Use Topics to group a coherent area of work, such as “Bookings and access”, “Using your equipment” or “Managing a partner team”. Within a Topic, distinguish an introduction, the main procedures and the exceptions people need to resolve. A Topic called “Operations Department” is less useful if customers do not know which department owns their issue.
Keep one authoritative article for each substantial process. Shared readers can use the same article where the process is the same. Create a separate role-specific guide when the available actions or consequences differ materially, rather than repeating the shared introduction in several places.
| Situation | Practical structure |
|---|---|
| A customer is new to the service | Start with a brief orientation followed by entry, booking and learning guidance |
| A partner coordinator manages a team | Keep the coordinator’s operational procedures together while linking to shared learner guidance where needed |
| Several product families share a process | Maintain the shared process once and link to the appropriate manuals or product-specific exceptions |
| One Topic has become difficult to scan | Split by recognizable tasks or stages; preserve existing article URLs while changing their Topic assignment |
Create and edit a Topic
Sign in as a Help Center administrator and open Content management → Topics. The list displays each Topic’s icon, title and description, with actions to create, edit or delete a Topic.
- Select Create and enter a clear Title and concise Description. The description should explain what readers can accomplish in this Topic.
- Choose an Icon that supports recognition without being the only indicator of meaning.
- Add a Backdrop image when it helps the Topic’s identity. It is used in the banner of articles assigned to the Topic.
- Select Create. For an existing Topic, open its edit action and select Update after changing it.
Uploading a backdrop is part of preparing the form. Save the Topic itself to retain the intended configuration. Choose artwork that remains legible behind article headings and avoid relying on embedded text that is difficult to read on small screens.
Control the reading order
Reorder Topics by dragging their handles in the Topics list. Topic ordering saves automatically. To arrange articles within a Topic, open Content management → Articles → Sort articles, select the Topic and drag the articles into the intended sequence. Verify the saved order from the Topic’s reader view.
Place orientation and main procedures before specialist exceptions. Readers can use the Topic’s Sorted view for the maintained sequence or Latest updated to find recently changed guidance. Updating an article is not a substitute for deliberately maintaining the Sorted sequence.
Connect guidance without creating a link directory
The article page already provides navigation to other articles in its Topic. Use links inside the text when a particular prerequisite, control or next step needs another explanation. Configure Related articles for a small number of strongly relevant guides from other Topics when they support the article as a whole.
For example, a guide to arranging a product-support appointment might link inline to the current preparation checklist. Its Related articles could connect the reader to the separate Resource Library guidance or account-access guidance. Select a destination the intended audience can read; selecting it as related does not grant permission.
Related article selections are directional. Linking article A to article B does not automatically add the reverse relationship. Review the destination’s needs separately rather than filling every sidebar with the same set.
Maintain Topics as the service grows
A Topic appears to a reader only when at least one assigned, published article is available to that reader. This keeps empty or irrelevant areas out of the reader’s navigation, but it means that an administrator’s complete Topic list is not a reliable preview of another audience’s homepage.
Before deleting a Topic, move its articles to their correct destination and verify their audience and navigation. Deleting the Topic does not delete its articles; unassigned material can become harder to locate. Use the Articles list’s No topic filter to find and resolve such gaps. Prefer improving an existing structure to creating several nearly identical Topics.
Verify the navigation
| Scenario or check | Expected result or evidence |
|---|---|
| A representative reader opens the homepage | Topic names and descriptions make their next task recognizable |
| A Topic has no published article for the reader | It is absent from that reader’s Topic navigation |
| The Sorted view is opened | The maintained article sequence supports the intended reading journey |
| A cross-topic related guide is opened | It serves a relevant next decision and the reader can access it |
| A Topic is reorganized | Existing useful article links still reach the intended content |
Troubleshooting
| Problem | What to check |
|---|---|
| A saved Topic does not appear on the homepage | Check that an assigned article is published and available to the current reader |
| The order looks different from the maintained sequence | Check whether the reader selected Latest updated rather than Sorted |
| An article seems to have disappeared after Topic cleanup | Find it in Content management → Articles using search or No topic, then assign the correct Topic |
| A related article is absent on the reverse page | Related selections are directional; configure the reverse relationship only if it is useful |
FAQ
-
Why can I see a Topic in administration but not as a reader?
A reader sees a Topic only when it contains at least one published article available to that reader. Check publication and article Roles selections as well as the Topic assignment.
-
Does deleting a Topic also delete its articles?
No. Move the articles deliberately before deleting the Topic. Use the Articles list’s No topic filter to locate articles that need reassignment.
-
Do Related articles create links in both directions?
No. The selection applies to the article being edited. Configure the other direction separately only when that relationship helps its readers.