Skip to main content
Skip table of contents

Childtabs Macro

The Childtabs macro automatically generates tabs with content from child pages.

Childtabs Examples

Childtabs with horizontal tabs (default)

Childtabs with vertical tabs

Settings of the Childtabs Macro



Root page

The page whose child pages you want to display as tabs. Leave blank for the current page.

Vertical orientation

Tick the box to display the tabs vertically. By default, tabs are oriented horizontally.


The width of the vertical tabs in pixels. The default is 150 pixels.
This parameter only makes sense if the vertical orientation is enabled.

Lock position

Tick the box to let the vertical tabs scroll with the content.
This parameter only makes sense if the vertical orientation is enabled.

Sort by

Choose how to sort the child pages.
Values: title, creation, modified


Tick the box to reverse the sort order.

Display excerpt

Tick the box to display the content from the excerpt macro or, if there is none, the entire page.
By default, the entire page is displayed.

Left truncation

The number of characters to truncate from the left of every tab title.
This makes sense in long page titles to save space. By default, the entire title appears.

How to use left truncation

Left truncation makes sense if you have long page titles with identical prefixes.

Use case:

You might have a number of pages all starting with "ch1 Child" that you want to display as tabs.

In order to save space, you can decide to cut (=truncate) the first 9 characters of each tab title. Here's how to do it:

  1. Include the macro on your page. Per default, it will look like this:

  2. Edit the macro and set "Left truncation" to 9. This means that the first 9 characters of each tab title will not be displayed.

  3. Select "Preview" to see the shortened tab titles.

  4. Once you are happy with the result, save the macro and publish the page.

Max amount of tabs

The max amount of tabs displayed. The default is 20 tabs.

Tab style

Tab style defines how tabs will look like in UI.

More details on the tab styles

As a user, you can switch between the tab style "Atlassian tabs" (default) and "index cards".

Switch between the styles by editing the macro and changing the "Tab style".

Tab style "Atlassian tabs" is the standard Atlassian tab layout. It is used as default.

Tab style "index cards" displays the tabs as cards (2D).

  • Childtabs Macro

    Comprehensive guide on using the Childtabs Macro in Navitabs, detailing features like vertical orientation, tab style, and left truncation settings.

  • Localtab Macro

    Structure your page's content in tabs. Must be used within a Localtab-Group macro.


If you are having trouble using this macro, please contact our App Support.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.