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.
Find different use cases of the Navitabs macro.
Child pages of "Parent Page", displayed horizontally (default):
Child pages of "Parent Page", displayed vertically:
Horizontal tabs, different root
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:
In this example, pages "nv5 - Tab 1" and "nv5 - Tab 4" both carry the label "nv5" specified in the macro settings.
Settings of the Navitabs macro
The following settings can be used for both children and labels mode.
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.
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.
Specify the name of the tab to display in the first position. This is useful for a "home" page.
The number of characters to truncate from the left of every tab title.
More details on left truncation
Left truncation makes sense if you have long page titles with identical prefixes.
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:
Left truncation of the first tab
Tick the box if you want to truncate the tab you defined as the "first tab" as well.
Settings for the children mode
Define the page whose child pages will be displayed as tabs. Leave blank for the current page. Use
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.
Settings for the labels mode
Generate tabs for pages containing one or more labels (comma separated). Tabs are sorted alphabetically by default.
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.