Practical PlaybookATLASSIAN
Your Confluence Page Tree Is Organized. Can Anyone Else Find the Answer?
- Author
- Alex Florian
- Published
- Updated
- Reading time
- 4 min
The person who arranged a Confluence space knows why a policy lives under a department, a program, and last quarter's working group. A new colleague knows none of that history. They know the question they need answered.
Both can look at the same page tree—the hierarchy of pages and child pages—and have completely different experiences. To its author, the structure is orderly. To the reader, the first useful clue may be missing. They have been given a filing system whose logic depends on already knowing where the answer belongs.
That is why I would hesitate before treating another large reorganization as the obvious solution. A page needs a stable home, but readers also need routes into it that begin with their work rather than the author's memory.
Follow the person who doesn't know the answer
Imagine a new employee asking, “How do I request access to the reporting application?” In this fictional space, the procedure sits under Operations / Transformation / Access working group. The author finds it immediately. The employee tries the onboarding page, then searches for the application's name.
Suppose the search returns a page called “Access model—phase two.” Its title may be meaningful to the project team, but it doesn't tell the employee whether it contains the current request procedure. They hesitate and ask a colleague in chat.
That hesitation is the useful observation. Moving the page to another branch might not resolve it. The missing information is what the page is for and whether it helps with the question at hand. A clearer title and a signpost from onboarding may do more than a new hierarchy.
The author's instinct is often to explain immediately: “Oh, you need this page under that program.” But the explanation supplied at that moment is precisely the context the knowledge system should have provided. Without it, the next colleague will need the same rescue.
A page can have one home and several approaches
The access procedure might belong in a stable service area. The onboarding page can still introduce it where the new employee needs it, while the application's help page links to the same procedure for existing staff.
Those entrances need not become copies. A short sentence can establish the relationship:
Illustrative signpost: Need the reporting application for your role? Use the application-access request procedure to see the approval requirements and submit your request.
That tells the reader what the destination will help them do. “See here” merely points somewhere.
Copying the whole procedure into onboarding would make it easier to encounter today, but create another version to maintain tomorrow. A contextual link preserves a useful route without asking two teams to keep the same instructions aligned. A local summary can still be valuable when its purpose and maintenance are understood.
Findability is not only where the document is stored. It is whether the reader can recognize a route to the answer.
Some relationships don't belong in the tree
A procedure may relate to a service, region, audience, and content type at the same time. One hierarchy cannot make every relationship its primary branch. Labels and links can provide other routes where they match how people search and work. Confluence supports labels for grouping related content and ordinary page editing for maintaining those signposts. [1][2]
A shared vocabulary helps. Several near-identical labels can divide the results just as confusingly as several near-identical page titles. More classification isn't automatically more guidance; it needs to make the next search more predictable.
A direct link also removes the surroundings the author relied on. The page itself should explain its purpose and whether its instructions are current, rather than expect the parent tree to provide all the meaning. An employee arriving from search needs that context just as much as one browsing the space.
This is distinct from deciding which conflicting policy has authority. That is the subject of the separate article on three Confluence policies. Here, the concern is the route an unfamiliar reader takes to the maintained answer.
Test the hesitation, not the author's explanation
After changing the title or adding the onboarding link, let another unfamiliar colleague try the same task without help. Watch where they choose, hesitate, or remain unsure that the answer applies. A successful search is not just a click on the right page; it includes recognizing that the page answers the question.
The result may justify keeping the existing tree and improving two entrances. It may reveal a branch that genuinely needs to move. Either conclusion is more useful than judging the hierarchy by how elegantly its creator can explain it.
A person who doesn't already know where the answer lives should be able to find it. That is the standard the page tree has to meet after its author leaves the room.