Skip to main content
How to create Confluence tabs: the step-by-step guide
Share on socials

How to create Confluence tabs: the step-by-step guide

A headshot of Holly Aspinall
Holly Aspinall
4th August, 2023
An open box on top of stacked closed boxes
A headshot of Holly Aspinall
Holly Aspinall
4th August, 2023
jump to section
What are tabs?
Why you should use tabs in Confluence
How to add tabs to a Confluence page
Make your pages even easier to navigate

Discover how to clean up your content and help users find answers faster with our guide to Confluence tabs.

Getting lost in a maze of Confluence content? Drowning in support tickets because users are struggling to find answers?
Don't fear, there's a simple solution! With tabs, you can take control of your overwhelming Confluence pages and help users self-serve faster.

What are tabs?

Tabs are a popular way to organise and present content.

While tabs all sit alongside each other, you can only see the contents of the active tab, with everything else hidden. To help users understand what's in the hidden tabs, every tab has a label to describe its contents. Tabs help you focus on the most relevant information, making navigating faster.
A gif showing a cursor clicking between tabs
You can use tabs in Confluence to organise your content by category or theme
In everyday life, you'll be most familiar with tabs in a web browser (such as Chrome, Firefox, or Safari). You can also find tabs in filing systems and diaries to help you quickly skip to the information you need. In Confluence, tabs sit within a page, with each tab acting as a container for related information or files.

Why you should use tabs in Confluence

Whether you have a knowledge base, documentation, or company intranet in Confluence, you should aim to provide a great user experience. With 69% of customers struggling to find answers on a company site and 79% of employees saying they appreciate tools with easier navigation, improving the structure of your Confluence pages can make your users happier and more self-sufficient.
Confluence tabs are the ideal way to do this. By cutting down clutter and hiding unnecessary information, you make it quicker and easier to navigate pages in Confluence.

How to add tabs to a Confluence page

🚨 Note: this guide is for Confluence Cloud. If you’re a Confluence Data Center user, you can head here to learn more about using tabs. 🚨

Before you begin

As Confluence doesn't have tabs built-in, you'll need an app from the Atlassian marketplace. You have two options:

a) Tabs for Confluence 🗂️
Best if: you only want to add tabs to your Confluence pages.

b) Content Formatting Macros for Confluence 🚀
Best if: you want an all-in-one toolkit to boost your page structure and make content more engaging. Alongside tabs, you get access to cards, numbered headings, tooltips, and much more.
Unsure which app is for you? Try them both free for 30 days:

Installed your app of choice? Now follow the guide below:

1. Open your Confluence page and click the ‘edit’ icon (the pencil).

From here, click on the +v in the Confluence toolbar and search “Tabs” to find the app. You can also find it by typing “/tabs” on your Confluence page.
A gif of a user clicking a dropdown menu on a Confluence page
3. Click on Tabs for Confluence to bring up the editor. Now follow the guide to create your first tab!
A gif of a user changing the colour of Confluence tabs in a dialogue box
Some tips for making great tabs:
  • Choose a tab name that's relevant to the content it will contain. This helps to reduce confusion and speed up user navigation.
  • Add an optional icon to add context or make your tab more engaging.
  • Click the Accent colour dropdown to assign a tab colour directly from your brand palette. Read our documentation to learn how to set a brand palette.

4. Press Save. Congratulations, you've created your first tab! You should see a tab placeholder on your page like this:
An empty Tabs for Confluence macro placeholder
5. Your tab starts its life as an empty container, so it's time to add content. You can add content from scratch or cut and paste information already on your Confluence page:
A gif showing a user pasting text into a Tabs for Confluence macro placeholder
6. To add more tabs to your group, repeat steps 2–5 above. You'll need to add a new Tab macro for every individual tab you want.

7. When you're done, hit 'Publish' to see your new group of tabs!
A gif showing a user clicking between FAQ tabs in Confluence
This guide shows just one way you can use tabs to present information for users - if you'd like more ideas and inspiration, check out our Tabs for Confluence sample page.

Make your pages even easier to navigate

Tabs are a great way to organise information on a page without overwhelming users. And though this guide focuses on tabs for Confluence Cloud, Confluence Data Center users can still enjoy tabs as part of Content Formatting Macros for Confluence.
However, it's important to remember that not all content is suited to tabs, especially if you want to keep a natural reading flow on your page.

If you’re looking to structure your Confluence content differently, we’ve got you covered! Our guide on numbered headings in Confluence shows you a great way to organise pages with sequences and steps.
Get tabs - and much more - in our complete macro toolkit!
Try Content Formatting Macros for free and see what you can achieve with your Confluence pages.
Written by
A headshot of Holly Aspinall
Holly Aspinall
Content Marketing Manager
Holly is dedicated to writing valuable, accessible guides that help users understand their tools better. She champions products that help modern workers do more with Confluence,, and beyond.

LinkedIn →
Content Formatting