How to Make Beautiful Pages in Confluence

Your audience is human and we humans don’t always see what's right in front of us.
According to research published by Time, 55% of people spend 15 seconds or less on a page. If your pages look like this, chances are high that people won’t absorb any of the information.

An aesthetically pleasing Confluence page isn’t just for beauty’s sake. It enables your team to find what they need and find things quickly.

In this article you’ll learn how to:

  • Best use widths and layouts

  • Add structure to your page

  • Highlight what matters

  • Deemphasize less important content

By the end, your Confluence pages will be works of art, and you won’t need to be the next Picasso to pull it off.

Want to see it in action? Check out how to make beautiful pages in Confluence on YouTube.


Communicating the Purpose of the Page

With the average person spending less than a minute on a page, it's important to communicate the purpose immediately and concisely. You can achieve this by putting the most relevant information at the top of your page.

  1. The Header Image communicates what your page is about. Don't add an image just for the sake of adding one. If you don’t have an image that communicates what the page is about, use a neutral image, or none at all.

  2. The Page Title is the most effective way to quickly and succinctly communicate the purpose of your page. The title of a page is important for a variety of other reasons, including searchability. Learn more about page naming conventions for better searchability in Confluence.

  3. Info Panel macros are great for conveying a bit more information about your page, other than your title or header image can convey. At first glance, the Info Panel stands out and catches the reader's attention.


Setting the Layout and Width

Adjusting the width and layout of a page can be very powerful when used effectively.

  1. Layouts make your page more readable and skimmable by breaking up information. It’s best to combine different layouts to group your content and create visual interest.

  2. Width is important depending on the type of content on the page. Written content like blog posts or employee handbooks are best written on narrow pages for readability. Tabular information, like tables and diagrams, are better on wider pages, where filling the screen enhances people’s experience.

If features like layouts and width are new to you, check out our introduction to the Confluence editor tutorial on Youtube.


Adding Structure and Sections

People will be able to locate the information they need more easily if your page is structured clearly.

  1. Headings are the most straightforward method of adding structure to a page. The highest numbered heading indicates a new section, one heading number lower indicates a sub-section, etc.

  2. The Divider macro is another simple way to split up your content in a page. It sections off the text with a line, which helps highlight where new content begins.

  3. The Table of Contents macro allows your end-user to find the section they want at the beginning of the page. This also gives the user a fairly simple breakdown of what the page contains.


Emphasizing and Highlighting Content

With your intro and headings sorted, you've given your page some structure. Now it’s time to highlight the most important information to ensure your readers won't miss it.

  1. Adding images helps quickly communicate the meaning of each section. A screenshot, table, chart, or suitable descriptive image can help people understand your written content more quickly.

  2. Bolded and colored text can help emphasize certain sentences in your page, making them stand out from the rest of the text.

  3. The Expand macro is a nice way to clean up a page that has a lot of information. This is great for bonus content that’s only valuable to some people. Just watch out, so you don’t hide important information that’s relevant for everyone.


Now let’s take a final look at what your Confluence page used to look like, versus the end result after optimising the design for better readability.

Beautiful page transformation.gif

Beautiful! 🤩

Tell Us Your Use Case

There are so many great ways to make pages more beautiful in Confluence. What's your favorite?
Let us know in the comments how your team creates beautiful pages.

If you liked this article, you can read the complete version on Rock the Docs, our guide for technical documentation in Confluence.

We have plenty more best practice articles for Confluence, and videos as well. Go to Rock the Docs 👉 



Andy Gladstone
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
October 20, 2022

Other than what you already mentioned in the article, tables are my favorite way to present data that can be associated by columns and rows. Using the /date macro to insert dates rather than typing it statically can highlight important dates and milestones. And finally, @ tagging stake holders creates a personal touch (and notifies them of their mention) that allows the user to find the data that is relevant to them and action it.

Like # people like this
Steffen Burzlaff _K15t_
Marketplace Partner
Marketplace Partners provide apps and integrations available on the Atlassian Marketplace that extend the power of Atlassian products.
October 21, 2022

Hi @Andy Gladstone thanks for your input.
These are indeed good additions to this article, thanks!

Tables are a very important part of a page and because of that we've dedicated a whole article about creating beautiful tables in Confluence.

I love your take on @-mentions that those are not just relevant to share information with stakeholders but that they also add a personal touch to pages. 


Lisa I October 21, 2022

My use case is to build a team site that lists a time off calendar, all of our customers, solutions, technical mapping, bus requirements, server information, software solutions, along with JIRA ticket integration.

How do we make beautiful pages?  We are looking to steal beautiful templates and make our page stand out. 

Who can we steal from:) 


Log in or Sign up to comment
AUG Leaders

Atlassian Community Events