Tabs for Confluence
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.
- Navigate to the page you want to edit.
- Click the Edit icon.
- Click Insert > View More in the Confluence editor.
- Select the Tabs for Confluence macro in the Select Macro screen.
- Click Insert. A macro placeholder is displayed.
- 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.
- 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.
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
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.