Tabs are UI elements that allow multiple contents within a single window. Tabs are used as a navigation for switching between sets of content. With tabs, it is possible to keep a large amount of data in a much smaller area than you usually need.

How to use

Please follow these steps to insert an Tabs macro on a Confluence page:

  1. Navigate to the Confluence page you wish to edit or create a new page.

  2. Once in edit mode, either click the plus icon in the navigation bar (insert elements) or press '/' on your keyboard to bring up the macro list.

  3. Type "Optics" in the search bar, then choose the Tabs macro from the options displayed.

When the configuration dialog opens, it guides you through customizing your button, with a live preview showing changes in real-time. Once you're satisfied, click Save to add the button to your Confluence page. If you decide not to proceed, clicking Cancel will cancel the setup without inserting the macro.

Tabs alignment

Select tabs alignment. By default, tabs are left aligned.

Tabs styles

Choose from three different tabs styles.

Create tabs

Use dropdown to create tabs. To change the icon and text, use inline editing option.


Click on icon and choose from more than 5000 icons available and attract even more attention. To change the icon position or remove label, use the “Icon” dropdown in the macro configuration.


Most of the native Confluence macros are available within the tabs editor.

Due to Atlassian limitations, it is not possible to insert and show third party macros within tabs.

Supported macros:

  • Text formatting

  • Content alignment

  • Bullets and numbering

  • Links

  • Images

  • Code snippet

  • Info panel

  • Date

  • Quote

  • Status

  • Table

Import Confluence pages

Use the option to add and edit whole Confluence pages within the tabs macro.


The Announcements macro will receive updates to improve performance and user experience. We will introduce the following features soon:

  • Colour and font configuration (active, inactive, and hover) RELEASED

  • Tabs width RELEASED

  • Preview mode with configuration options RELEASED

  • Add and manage action points and decisions in tabs RELEASED

  • Nested tabs progress

If you have any questions, need more detailed information, or want to share feature suggestions, please feel free to contact us.