Skip to main content
Skip table of contents

Navitabs Macro

The Navitabs macro provides the following modes (only one of them can be active at a time):

  • Children (Default): Define a parent/root page. This generates tabs for all child pages of the current or any specified page.

  • Labels: Define a specific label. This generates tabs with all pages carrying the specified label.

Click on any tab to navigate to that page. 

The Navitabs macro is a navigational macro, displaying links as tabs. If you want to display the content of pages in the tabs, use

Find different use cases of the Navitabs macro.

Click here to expand...

Child pages of "Parent Page", displayed horizontally (default):

Click here to expand...

Child pages of "Parent Page", displayed vertically:

Click here to expand...

Child pages of the root page "Navitabs Macros", displayed vertically, with a short text next to them.

What this looks like in the macro editor:

Click here to expand...

In this example, pages "nv5 - Tab 1" and "nv5 - Tab 4" both carry the label "nv5" specified in the macro settings.

The following settings can be used for both children and labels mode.



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.

Tab style

Tab style defines how tabs look in the 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).

Use Without Body

Enable this option if you use the macro without a macro body. By default, the macro body is used.

First Tab

Specify the name of the tab to display in the first position. This is useful for a "home" page.

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.

More details on 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.

Left truncation of the first tab

Tick the box if you want to truncate the tab you defined as the "first tab" as well.



Root page

Define the page whose child pages will be displayed as tabs. Leave blank for the current page. Use @parent for the parent page.

Include root page

Tick the box to add an additional tab for the root page.


The depth of child pages for which tabs are generated. The default is 1.

Sort by name

Tick the box to switch from sort by position (default) to sort by name.


Tick the box to reverse the sort order.




Generate tabs for pages containing one or more labels (comma separated). Tabs are sorted alphabetically by default.
By setting this parameter, you switch from "children" to "labels" mode.

Space key

Specify a space to only display labelled pages from that space. In most cases, it makes sense to limit the tabs to the current space.

Sort by label

Tick the box to switch from sort by name (default) to sort by a label.

  • Labeltabs Macro

    Learn to use Labeltabs Macro in Navitabs, covering features like label filtering, vertical/horizontal tab orientation, and tab style customization.

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

  • Navitabs Macro

    Display page trees (child pages) or page labels as tabs. Click on any tab to navigate to that page.

  • Handpicked Tabs Macro

    Generate tabs with the content of selected pages.

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.