Tab Group

Owned by Elizabeth Tai
Last updated: Sept 21, 2023 by Smita Nair
3 min read

Description

Allows for the creation of tabbed content in coordination with the Tab macro. 

This macro is available in Server, Data Center and Cloud.

  • In Server & Data Center, It is used for migrating Card macros to Cloud.

  • In Cloud, it is marked as Legacy macro as it is only compatible with Confluence Cloud Legacy Editor.

  • For tabbed content in Confluence Cloud New Editor, use Tabs macro instead.

Notes about migration

  • Some legacy Macro parameters from Confluence Server are not supported. More details are available on our FAQ page. 

  • Server users migrating to Cloud will not lose any data.

  • Some server-version parameters are currently unsupported and are ignored by the macro. For example, Server users migrating to Cloud will lose some CSS and UI functions.

The Tab Group macro must contain at least one Tab macro within its body.

Server

Cloud

Server

Cloud


Parameters

Name

Required

Available In

Migratable to Cloud?

Default Value

Description

Name

Required

Available In

Migratable to Cloud?

Default Value

Description

ID

 Yes

Server, Data Center, Cloud

Yes



The ID for the Tab Group. Must be unique to this page.

Tabs Location

 Yes

Server, Data Center, Cloud

Yes

Top

Choose the position to locate the tabs:

  • Top

  • Left

  • Right (Not supported in Composition Cloud, the position will default to "Top".)

Border color of the active tab

 Optional

Cloud

No

 

Choose a color for the border.

Background color of the active tab

 Optional

Cloud

No

 

Choose a background color of the active tab.

Border color of inactive tabs

 Optional

Cloud

No

 

Choose a color for the border of inactive tabs.

Background color of inactive tabs

 Optional

Cloud

No

 

Choose a background color for inactive tabs.

Width

 Optional

Server, Data Center

No

 

  • The width the content will be constrained to (not including any tabs).

  • If not set, the tabs expand to display their content.

Height

 Optional

Server, Data Center

No

 

  • The height the content will be constrained to (not including any tabs).

  • If not set, the tabs expand to display their content.

History

 Optional

Server, Data Center

No

true

If enabled, the tab will update the page URL when switching tabs and each navigation between the tabs will be treated as an entry in the browser history.

CSS Class

 Optional

Server, Data Center

No

 

The custom CSS class the deck is decorated by.

Start Hidden

 Optional

Server, Data Center

No

true

If set to false, the cards will be initially visible on the page until setup is complete.

Loop Cards

 Optional

Server, Data Center

No

 

If true, the deck will loop back to the beginning from the last card.

Next After (in Seconds)

 Optional

Server, Data Center

No

never

  • The number of seconds the slides will stay visible before moving to the next one.

  • By default the current slide will not transition until prompted by the user.

Effect Type

 Optional

Server, Data Center

No

none

The effect to use when moving to a new slide. You can set it to:

  • fade

  • none

Effect Duration (in Seconds)

 Optional

Server, Data Center

No

1

  • The number of seconds the transition will take to complete, e.g.: 1.5 or 10


Editor View


Macro Edit View