The Tabs for Confluence macro allows you to add horizontal tabs to a page to display interactive, categorized, or isolated information. This macro can be used for formatting content using either Confluence's new Cloud editor or the legacy editor. A tabs macro must be added for each tab that you want to display.

You can add only one array of tabs to a Confluence page.


The instructions below describe how to use the macro with Confluence's new Cloud editor. If you would like to learn more about formatting content or general macro use in Confluence, see Atlassian's documentation.

  1. Navigate to the page you want to edit.
  2. Click the Edit icon.
  3. Click Insert > View More in the Confluence editor.
  4. Select the Tabs for Confluence macro in the Select Macro screen.
  5. Define the tab with the following parameters:
    • Title: Enter the title to be displayed on the tab, e.g. Venue.
    • Ordering Index: Specify the order in which the tab should be displayed in relation to other tabs. For example, enter 1 if the tab page will appear first.
  6. Click Insert. A macro placeholder is displayed.
  7. Click inside the placeholder to add the content that you want to display on the tab page, for example, type or paste text, insert images, links, or bodiless macros. See Limitations below to learn more.
  8. Add an additional Tabs macro for each tab page that you want to display, for example, add additional macros for Workshops, Facilities, and Directions, defining the Ordering Index accordingly.
  9. Click Publish to see the rendered tabs on the page.

To quickly add a macro when editing a page, use the keyboard shortcut by typing / and the beginning of the macro name to display a list of matching macro names, e.g. /tabs. If you are on a page that uses Confluence's Cloud legacy editor, type{ instead, e.g. {tabs.

Edit the Macro

To make changes to the macro, for example, to change the order of the tabs, click the macro placeholder then click the Edit icon. Make the required changes, then click Save. To remove the macro, click the Edit icon, then click the Trash icon.


You can add bodiless or plain text macros to a Tabs macro, e.g. a Button, Table, or Code Block macro. These either have no additional text content area or allow only plain text without formatting such as color, special fonts, or attributes such as italics. Due to Atlassian Cloud limitations, you cannot include the rich-text macros that allow customized formatting for example, a Chart or Expand macro cannot be nested within our Tabs macro. More information on the parameters of specific Confluence macros can be found in Atlassian's documentation.

Want to get started but don't have the app? See our Installation page to learn more.