Skip to main content
Skip table of contents

Tab Macro

The Tab macro structures your page's content in tabs. This macro must be used within a Tab Group macro.

When to use Tab Macros

This macro is helpful if you want to:

  • structure your long Confluence page to prevent excess scrolling

  • put additional information in tabs instead of displaying them in the main content (eg. related pages, Child Display, Jira issues, Page Properties, or other macros)

(info) This macro was formerly called "Localtab (New Editor) Macro".

How to use Tab Group and Tabs macros

  1. Add a Tab Group macro to a page.


  2. Place the cursor inside the Tab Group macro. Add a Tab (used within a Tab Group macro) macro.


  3. Give your tab a title and close the macro editor. Note: the tab title will only appear once you have published the page.

    Macro - Tab.png

    (tick) Tipp: Paste an emoji from another tool into the Tab title to make the tabs stand out more (see below).

  4. Position the cursor right behind the Tab macro and hit enter.

  5. Enter your content below the Tab macro.

  6. To add another tab, place the cursor below the content you have just entered. Add another Tab macro and add the new content below.

  7. Save the page when you are done.

  8. The resulting tabs look like this:

  9. By default, the first tab's content will be displayed when loading the page. If you want the second tab's content to be displayed, edit the Tab called "second tab" and tick the box "Active". 

  10. If you want vertical tab navigation instead, edit the Tab Group macro and activate the toggle "Display the tabs vertically." Note that the preview will not change here; the tabs will only be oriented vertically once you have published the page.

  11. If you want to customize the tab icon, click the placeholder next to the tab name to browse for the appropriate icon


👍 Working with emojis in the Tab Macro

Emojis are a quick and fun way to draw more attention to your content. Wouldn’t it be cool to use them to embellish individual tabs? This is possible with a tiny detour 🎉 !

Unfortunately, you cannot use Confluence’s emojis library when giving your tab a title. However, you can use any external emoji tool, copy the emoji into the clipboard, then paste it before or after the tab title.

The embellished tab titles will appear on the published page in the selected tab design:

Linking to a specific tab

By default, the first tab and its content is displayed when a tabbed page is loaded. If you want to link to another tab instead, proceed as follows:

  1. Create the tabs and their content.

  2. Publish the page.

  3. Click on the tab you want to be active when the page is loaded. This will change the Confluence URL and add a hash, so it will look something like this: Your+Page+Name#8394215a-b9f7-4b2a-8c58-0b0d47eed0d4

  4. Copy the entire URL and paste it in other Confluence documents. The smart link will display the entire hash, so you may want to edit the link text manually.

Please note:

  • Using this URL will not scroll to the selected tab content. It will only select a specific tab and display its content.

  • This will not work for nested navigation; it’s impossible to link directly to a tab that lies in the content of another tab.

Related Content

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.