Skip to main content
Skip table of contents

Labeltabs Macro

Define a specific label in this macro. The macro will automatically generate tabs from all pages with the defined label and display their content in them.

Settings of the Labeltabs Macro

Name

Description

cql

Filter for a label (required) as well as any additional CQL field (optional).

Vertical orientation
vertical

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

Width
width

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
positionFixed

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

sort

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

Reverse
reverse

Tick the box to reverse the sort order.

Display excerpt
onlyexcerpt

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
ltrunc

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
maxtabs

The max amount of tabs displayed for the current filter. The default is 20 tabs.

Tab style
tabStyle

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



Examples

Labels “cats” OR “dogs”

If you want to generate tabs of pages containing the label cats or dogs:

  1. Include a Labeltabs macro on your page.

  2. Add "cats" and "dogs" as labels. Select "Save".

  3. The macro looks like this in the page editor:

  4. Save/Update your page.
    The pages containing the label "cats" OR "dogs" will be displayed as tabs.

Labels “cats” AND “dogs”

If you want to generate tabs of pages containing the label cats AND dogs:

  1. Include a Labeltabs macro on your page.

  2. Add "cats" as a label.

  3. Select the link "Add a filter". Enter "Label" and add "dogs". Select "Save".

  4. The macro looks like this in the page editor:

  5. Save/Update your page.
    Only the pages containing the labels "cats" AND "dogs" will be displayed as tabs.

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

Support

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.

Contact Support Close