Tabs
The Tabs macro allows you to add tabs to provide interactive, categorized, or isolated information to the page. A Tabs macro is added for each tab that you want to display.
You can now add more than one array of tabs to a Confluence page.
Walkthrough
Watch our video walkthrough to see the Tabs macro in action.
Instructions
Navigate to the page you want to edit.
Click the Edit icon.
Click Insert > View More in the Confluence editor.
Select the Tabs macro in the Select Macro screen. (Alternatively, use
/and begin to typetabto access the macro via the quick insert menu.)
To start a new tab array on a page select the Start New Tab Group checkbox.
You only need to select this check box if you have multiple tab groups on a page. It only affect the tabs that follow it, so you only need select it at the start of a second group of tabs.
Select the New Tab Group Direction; this can be vertical or horizontal. The arrangement of all the tabs on a page is decided by the setting in the editor of the first tab in a group.
- Enter the title to be displayed on the tab, e.g. Venue.
- (optional) Select a color using the color picker. This will change the color of the tabs headings. The color you pick in the first tab will decide the color for all the tabs in the group.
- (optional) Select the check box if you want to add a border to your tabs.
Click Save. A macro placeholder is displayed.
Add the content that you want to display on that tab.
Add an additional Tabs macro for each tab that you want to display, for example, we added additional macros for Workshops, Facilities, and Directions. In the following image.
The order in which you arrange the tabs on the page is the order in which the tabs will be displayed
Click Publish to see the rendered tabs on the page.
Horizontal Arrangement
Vertical Arrangement
Example Style Options
Edit the macro
To make changes to the macro, for example, to change the title of the tabs, click the macro placeholder then click the Edit icon. Make the required changes, these will save automatically.
To make changes to the order of the tabs, change the order of the macros on the page. Drag and drop the macros to do this.
Add Multiple Tab Groups
- Add the tabs macros as normal.
- At the start of your new tab group select the Start New Tab Group checkbox.
Choose the New Tab Group Direction.
The New Tab Group Direction in the first tab is applied to all the tabs in its group. Selecting this option for following tabs will have no effect on the group.
Publish your page to see your multiple tab groups.
Macros Inside Tabs
It is possible to put some macros inside tabs. Some larger or more complex macros may not work, or work differently than expected.
| Macro | Works As Normal | Notes |
|---|---|---|
| Alert Macro |
| The alert will display each time that the tab holding it is clicked. |
| Button Macro |
| |
| Button Group |
| This type of macro will not fit inside a tab. |
| BibTeX Reference Macro |
| References within tabs will only display in a Summary Macro in the same tab. |
| BibTeX Summary Macro |
| The Summary Macro will only list BibTeX references within the same tab. |
| ||
| Footnote Macro |
| Footnotes within tabs will only display in a Summary Macro in the same tab. |
| Footnote Summary Macro |
| The Summary Macro will only list Footnote references within the same tab. |
| LaTeX Macro |
| |
| Progress Bar Macro |
| |
| Round Rectangle Macro |
| This type of macro will not fit inside a tab. |
| Tabs Macro |
| This type of macro will not fit inside a tab. |
| Tooltip Macro |
|
| Macro | Works As Normal | Notes |
|---|---|---|
| Action Item |
| The boxs are displayed but can't be checked. |
| Attachments |
| Inside a tab this macro displays the attachements on the page. However the drag and drop upload function does not work. |
| Blog Posts |
| |
| Bullet List |
| |
| Code Snippet |
| Code is shown but line numbers are absent. |
| Contributors |
| |
| Contributors Summary |
| |
| Chart |
| This type of macro will not fit inside a tab. |
| Change History |
| |
| Children Display |
| |
| Content by Label |
| |
| Content Report Table |
| |
| Create From Template |
| |
| Date |
| |
| Decision |
| |
| Decision Report |
| |
| Dropbox |
| |
| Emojis |
| Emojis display as stars. |
| Error Panel |
| The box appears but the style is different. |
| Excerpt |
| This type of macro will not fit inside a tab. |
| Excerpt Include |  | |
| Expand |
| This type of macro will not fit inside a tab. |
| Files and Images |
| |
| Gallery |
| |
| Iframes |
| |
| Include Page |
| |
| Info Panel |
| The box appears but the style is different. |
| Jira Charts |
| |
| Jira Issue |
| |
| Jira Roadmap |
| Only displays a link. |
| Layouts |
| This type of macro will not fit inside a tab. |
| Labels List |
| |
| Link |
| |
| Mention |
| |
| Note Panel |
| The box appears but the icon is missing. |
| Numbered List |
| |
| Opsgenie Incident Timeline |
| |
| Page Index |
| |
| Page Properties |
| This type of macro will not fit inside a tab. |
| Page Properties Report |
| |
| Page Tree |
| |
| Page Tree Search |
| |
| Popular Labels |
| |
| Profile Picture |
| |
| Related Labels |
| |
| Recently Updated |
| |
| Recently Updated Dashboard |
| |
| Roadmap Planner |
| The roadmap displays, but the links do not display when you hover over the bars. |
| Shared Links Bookmark |
| |
| Spaces List |
| |
| Status |
| |
| Success Panel |
| The box appears but the style is different. |
| Table |
| |
| Table of Contents |
| |
| Table of Content Zone |
| This type of macro will not fit inside a tab. |
| Task Report |
| |
| Trello Card |
| |
| Trello Board |
| Although the board will display in edit mode, it does not display in view mode. |
| User Profile |
| |
| Warning Panel |
| The box appears but the style is different. |
| Widget Connector |
|