Use the Tabs Macro


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 add more than one group of tabs to a Confluence page.

Instructions

  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 macro in the Select Macro screen. (Alternatively, use / and begin to type tab to access the macro via the quick insert menu.)

  5. 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 affects the tabs that follow it, so you only need select it at the start of a second group of tabs. 

  6. 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.

  7. Enter the title to be displayed on the tab, e.g. Venue.
  8. (optional) Add color to your tab titles. 
    1. Select the color palette you want to use
      1. Default offers you seven colors. 
      2. Recently used offers you the last seven colors you used in any of our macros. 

      3. Local Space  - The options offered in this palette are specific to the space. The Space Admin can create and edit this palette. This may be used for your team's colors of choice.

      4. Organization - This palette offers the same options in every space. Confluence Admins can create and edit this palette. This may be used for your organization's brand colors.

    2. Select a tab title color. Either click on a color or select the paint can icon to choose a custom color.
    3. Select the check box to apply the color to a border as well.
  9. (optional) Choose a text alignment option. This changes the alignment of the content of the individual tab. Each tab can have a different alignment.
    Options are Left, Centre, or Right.

  10. Click Save. A macro placeholder is displayed. 

  11. Add the content that you want to display on that tab.

  12. 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

  13. 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

  1. Add the tabs macros as normal.
  2. At the start of your new tab group select the Start New Tab Group checkbox.

  3. 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.

  4. Publish your page to see your multiple tab groups.

Put Other Macros Inside

It is possible to put other macros inside this one. Some larger or more complex macros may not work, or work differently than expected. 

When trying to figure out which marcos can be put inside others there it helps to identify the type of macro you are working with. There are two general types of macro:-

Rich Body Macros -There are macros that you can type in on the Confluence Edit page

Simple Macros - These are macros that you can not add anything to on the edit page, you can only affect them by opening them in the editor.

Typically Rich Body Macros, do not work as expected, or at all when put inside other Rich Body Macros.

Most, but not all Simple macros can be put inside a Rich Body Macro, and often work as expected.


See below for more information on what happens when you put various macros inside this macro.


MacroWorks As NormalNotes
Action Item


Attachments

This macro displays the attachements on the page. However the drag and drop upload function does not work. 
Blog Posts


Bullet List


Code Snippet


Contributors


Contributors Summary


Chart

This type of macro will not fit inside another macro.
Change History


Children Display


Content by Label


Content Report Table


Create From Template


Date


Decision


Decision Report


Emojis


Error Panel


Excerpt

This type of macro will not fit inside another macro.
Excerpt Include



Expand

If you wish to use this macro you can put it in the cell of a table, inside the macro.
Files and Images


Gallery


Iframes


Include Page


Info Panel


Jira Charts


Jira Issue


Jira Roadmap

Only displays a link.
Layouts

This type of macro will not fit inside another macro.
Labels List


Link


Mention


Note Panel


Numbered List


Opsgenie Incident Timeline


Page Index


Page Properties

This type of macro will not fit inside another macro.
Page Properties Report

This macro works as normal except when the table contains any other macros. 
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


Table 


Table of Contents


Table of Content Zone

This type of macro will not fit inside another macro.
Task Report


Team Calendars


Trello Card


Trello Board

Although the board will display in edit mode, it does not display in view mode. 
User Profile


Warning Panel


Widget Connector


On this page