You're on your way to the next level! Join the Kudos program to earn points and save your progress.
Level 1: Seed
25 / 150 points
1 badge earned
Challenges come and go, but your rewards stay with you. Do more to earn more!
What goes around comes around! Share the love by gifting kudos to your peers.
Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!
Join now to unlock these features and more
The Atlassian Community can help you and your team get more value out of Atlassian products and practices.
Anyone using Confluence has probably heard or asked this question at one point or another. For as good as the Confluence search is at helping you find the right content at the right time, the search functionality isn't fully effective if your pages are poorly-named or your Confluence space structure is messy.
In the video below, we dive into some best practices you and your team can employ to ensure your Confluence pages and spaces are set up to be found quickly and navigated in the right way, including some tips and examples of how our team at K15t applies these practices in our Confluence instance.
🎥 Check it out:
We also share a synopsis of these tips below 👇
When naming a Confluence page, ask yourself: "How would I or my teammate search for this content in Confluence?" and use those assumptions to guide your title decision. Keywords are especially important to consider as they help Confluence determine how relevant the page is to the search criteria.
Adding a timestamp to your Confluence page title can help readers understand how relevant the page content is. Timestamps also help you avoid that pesky problem of not being able to duplicate your page titles in the same space!
Here at K15t, we use timestamps in our page titles to help differentiate a number of our planning pages. Some examples include:
We find the YYMM structure to work quite well throughout K15t, but perhaps your team has a structure that fits better. What's important is that your organization find and agree on a consistent structure so that everyone understands how to apply the timestamp and navigate these types of pages.
Most teams make use of Confluence page hierarchies to replicate the kind of folder-structure you might find in other content management systems. Make sure your team is aware of the purpose of parent and child pages and how to use them to group similar content.
For example, commonly created or repetitive pages like meeting notes or your team's bi-weekly retrospective meetings should be nested under a single parent page.
If there's a page hierarchy that works well for your team, try to replicate the structure for other topics too.
Whenever possible, use short and unique page titles. This is especially important in deeper page hierarchies where pages are nested at multiple levels in the page tree and the page titles start to get cut off. In these scenarios, prefixes can help keep your page title short, unique and still informative.
Here are some of the ways we employ prefixes in our page titles at K15t:
Maintaining a great Confluence system requires continuous effort from the team. Set aside time to review the content in your space, delete or archive obsolete content, and move pages around to maintain the structure you want. If you’re a site admin, set up rituals around maintaining your space.
At K15t, we promote a 'Space Gardener' in each team. This individual is responsible for enforcing space structures and page naming conventions, checking that content is up-to-date and archiving pages when they become irrelevant.
What are some of your conventions when it comes to naming your Confluence pages? We'd love to hear about your team's approach.
If you liked this article, you can read the complete version on Rock the Docs, our guide for technical documentation in Confluence. We also have plenty more best practices to share in the guide. Check it out 👉
Shannon Meehan _K15t_
Product Marketing Manager