Labeltabs Macro

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