Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Earn badges and make progress

You're on your way to the next level! Join the Kudos program to earn points and save your progress.

Deleted user Avatar
Deleted user

Level 1: Seed

25 / 150 points

Next: Root


1 badge earned


Participate in fun challenges

Challenges come and go, but your rewards stay with you. Do more to earn more!


Gift kudos to your peers

What goes around comes around! Share the love by gifting kudos to your peers.


Rise up in the ranks

Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!


Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

📖 How to build an Internal Knowledge Base in Confluence with Demo Page

Knowledge is key and should be easily found. 🔎 And that is why I want to introduce you to a sample landing page for an internal knowledge base.

In my example I chose a specific topic, but the following tips and insights can be applied on all landing pages for knowledge bases.

Furthermore I want to tell you a little bit about the reasons why it is build the way it is. Because I just love UX, and I think it’s valuable to know a couple of tricks to create practically but appealing pages in Confluence.

So without further ado here comes a screenshot of the page (click on the picture to enlarge) and you’ll find everything worth knowing beneath. 💙



Header, Introduction and Content sorted by Label

The header picture is our entry point for all our users visiting our knowledge base. And yes, you could simply use a heading but let me tell you why a header with an illustration is a great idea:

  • 40% of us respond more to visuals than to text

  • visuals are processed 60.000x faster in our brain than text

Images - like the little flat illustration on the right - are able to catch our notice easily and readers are immediately drawn to them. The human brain is able to recognize a familiar object within 100 milliseconds, so when we see a picture, we are quick to analyze it. 👀

But enough about our (pretty) header. Underneath we wrote two sentence about what can be found here. Two sentences are enough to inform the users if they’re on the right page.

And now we’re using some fun macros to point out our content. But before we’re taking a look into the macro: Did you notice the heading? With the little sentence “Explore the Knowledge Base” we not only invited and encouraged our visitor but also urged the user to do some thing. A very simply way of telling your users that they’re welcome and that they can be exploratory.

Now let’s talk about our first macro: “Labels List”.

A user needs to easily navigate and with this handy list he can not only find the things he is looking for easily but also gets an overview of the included topics.


Highlighted Pages, Popular Articles and the newest Updates

Okay, but maybe our user is not looking for any help on a specific topic but rather for a collection of information. 💡

For this I included tiles that will draw the attention to bigger resources - in this case a beginners guide (helpful for on boarding new employees) and an exam preparation course (great for training).

Both held links that will direct the user to new landing pages or new content.

For creating such tiles you can either include an image and than put link behind it or use an app. I’ve used the app Aura to create these two teasers.

Another important thing about an internal knowledge base is to include the newest resources and updates. This can be easily done by using the ‘Blogpost’ macro. Another way to highlight content in your knowledge base is to introduce the category “Popular Articles”. ⭐

Use Confluence Analytics (if you’re are on a Premium or Enterprise plan) or find your popular content either by page likes or internal surveys. Label those pages (for example with the label “popular-knowledge-article”) and use the macro “Content by Label” to insert valuable pages.


Support and other helpful Resources

Last but not least: Don’t let your users alone. Make sure to let them know where to get help if they have questions or problems. 💬

Also: Link/Pin other helpful resources. Include links to trustworthy external documentation such as the Atlassian documentation or the documentation of an app vendor.


That’s a wrap! If you made it this far: Thank you for reading! I hope you found this post inspiring or informative.

If you would like to see another landing page, leave a comment so I can make sure to start a new blogpost. If you like Confluence and Jira tips you can follow me here.

Thanks so much and let me know what you think about this article.



Wow - how is anyone gonna top this? - This is really great @Svenja 

Like Svenja likes this

Thank you very much @Guillaume De Smedt! I'm so glad you like my very first article. ☺️

Like Guillaume De Smedt likes this

You have detailed out to a good extent and it's need a :

Meanwhile, feel free to check out my submitted article in ACE  for #atlympics.

Like Svenja likes this
Svenja Rising Star Jul 28, 2021

Your applause is really appreciated! I was afraid whether there were perhaps too many details because this atricle has grown long, but I also thought they were all important. 😉 Thank you @G subramanyam

Like G subramanyam likes this

Looks really good! I like the style :) 

Like Svenja likes this
Svenja Rising Star Aug 06, 2021

Thank you @Clara Roder!!!

This is really nice!  I like the way you put this together.  I may use this with some tweaks of my own!  Thanks for posting!


Log in or Sign up to comment

Atlassian Community Events