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 to your page for each tab you want to display when you publish the page, this lets you add and edit the content for each tab without having to open the editor. You can add all the tabs you need for a single group of tabs in one go. You can also add more than one group of tabs to a page to keep everything grouped and organized how you need it.

Create a new set of tabs

Navigate to the page you want to edit.
Click Edit.
Click Insert → View Morein the Confluence editor.
Select the Tabs macro in the Select Macro screen.
Tip: Alternatively, type / and begin to type tab to access the macro via the quick insert menu.
When the editor opens, it contains two tabs. From this editor, you can select from the following options:
- Add more tabs
- Delete tabs
- Rearrange tabs
- Customize individual tabs, e.g., add a name or icon
- Style the group of tabs
Give your tabs names.
Select Save.
The macro placeholders for each tab appear on your page.
Add your content, and publish the page to see the final results.

Add tabs to the group

To add more tabs to a group already on the page, follow these directions.

Select a tab in the group and select Edit.
In the editor, select Add Tab.
Customize your tabs.
Select Save.
The macro placeholders for the new tabs appear on your page.
Add your content, then publish the page to see the final results.

Delete a tab

There are two ways to delete a tab: inside the editor or on the edit page.

Inside the editor

You can use the trash to delete a tab from inside the editor. Once you select Save, the macro placeholder for the deleted tab is removed from the page. All the content inside the tab is also deleted. Trash/Delete option within Tabs options

From the edit page

You can delete a tab from the edit page by selecting the placeholder for the macro you want to delete and then selecting the trash icon. The macro and all its content are deleted.

Rearrange tabs

We recommend rearranging tabs inside the editor. This makes sure your tabs stay in the same group. If you rearrange the tabs on the edit page, you can split them into different groups by moving the first tab.

You can change the order of your tabs by dragging them around inside the editor.

Select and hold the drag icon next to the tab you want to move, then drag it to its new position.
Select Save.

Customize each Tab

Name your tabs

Adding or changing a tab's name is done in the editor. Each tab must have a name before you can save the tabs.

Select a tab in the group, then select Edit.
Click the name field of the tab you want to change.
Enter the new name of your tab.
Select Save.

Edit or delete an icon on a tab

To edit or delete an icon on a tab, you must open the editor for the tab you want to change. The icon is shown beneath the tab's name.

Select the pencil icon to choose a different icon.
Select the trash icon to remove it.

Align text in a tab

The alignment of content inside each tab can be set inside the editor. Different tabs can align their content differently. Use the alignment buttons for each tab to change how its content appears.

Style your tabs

Any styling options you choose are applied to all the tabs in that group.

Change the header style

There are three possible header style options.

Basic
Filled
Rounded

Change the accent color

You can change the color used in the header to suit your preferences and you can also choose to add a border in the same color.

Changing the color palette gives you different color options.

Put a border around your content

You can add a border to your tabs. This can be a good way to let your readers know when they've reached the end of a long tab.

Just select Add border from the toggle. The color of the border will be the same as the accent color.

Make tab headings sticky

If your tabs contain a lot of content, you might want the tab headings to stay visible as you scroll. You can turn this on in the first tab in the group by selecting the checkbox at the bottom of the editor.

Change the tab direction

There are two options for the tab direction. To switch between the two options, select Tab group direction.

Horizontal arrangement

Vertical arrangement

Edit your Tabs

To edit a tab group, select one of the tab placeholders and select the edit icon.

Add more tab groups

To add further groups of tabs to a page, add a new Tabs macro to the page and follow the same process.