Pages to Tabs

Pages to Tabs

Description

The Composition - Pages to Tabs macro automatically renders as tabs all child pages of a specified parent page or specified pages from different spaces. In addition, you can:

  • Rename the tabs with custom names.

  • Position the tabs to the side or top.

  • Customize the design of the tabs.

  • Rearrange the order of the tabs.

Refer to this user guide page on how to use this macro.

Macro editor

Step 1: Source pages configuration

The first step in the macro editor lets you configure the source pages for the tabs.

pages_to_tabs_config.png

The following table provides details about the options in the first step of the macro editor.

Name

Required

Default Value

Description

Name

Required

Default Value

Description

Source

 Yes

Parent page

Can be:

  • Parent page: Lets you specify a parent page whose child pages you want to display as tabs.

  • Page selector: Lets you specify any pages you want to display as tabs. These pages can be located in different spaces. 

Parent page

Only if Source is set to Parent page.

Yes

<Current page>

The parent page whose child pages you want to display as tabs.

You can enter keywords in the box to filter the pages by name. 

Page selector

Only if Source is set to Page selector.

 Yes

N/A

The pages you want to display as tabs.

You can enter keywords in the box to filter the pages by name.

Users can only view pages based on their permission level.

Step 2: Tab customizations

The next step in the macro editor loads the specified pages as tabs. See the Pages to Tabs | Supported tab content section later on this page.

pages_to_tabs_content.png

You can:

  1. Edit the tab titles. You cannot edit the tab content, as it automatically loads from the source pages.

  2. Customize the design of the tabs. The expandable Tabs customizations panel on the left offers flexibility to match your design preferences, with options to adjust tabs' position, style, font size, and color. The following table provides details about the options in the Tabs customizations panel.

Option

Description

Choices

Default

Option

Description

Choices

Default

Tab position

Specify where the tabs are positioned on the page.

  • Top

  • Side

Top

Tab style

Choose the visual theme for your tabs.

  • Default

  • Blocks

  • Top highlight

Default

Tab font size

Adjust the size of the text on the tabs.

  • Small

  • Medium

  • Large

Small

Tabs color

Customize the colors for active and inactive tabs.

First line: Active tab colors
Second line: Inactive tab colors

Dark blue (Active tab)
Blue (Inactive tab)

Supported tab content

The following table lists which content or macros are supported within the Pages to Tabs macro. Note that the list below might change in the future with new cloud releases.

Content/Macro

Compatible

Notes

Content/Macro

Compatible

Notes

Fonts

  • Normal text

  • Heading 1, 2, 3, 4, 5, 6

  • Bold, italic, underline

  • Strikethrough

  • Code

  • Superscript, subscript

  • Text color

Yes

 

Text alignment

Yes

 

Lists

  • Bullet

  • Numbered

Yes

 

Check List

No

Appear as bullet points.

Links

Yes

All modes (URL, card, inline) will display as URL.

Files & Images

Yes

  • Base64 encoded PNG are not supported.

  • Invalid files or images appear with different styling.

Mentions

Yes

  • Displays as blue if it matches the logged-in user.

  • Displays as grey if it matches a user who is not logged in.

  • Clicking and hovering @mentions have no effect.

Emojis

Yes

Some emojis are displayed as a blue star. (This is an Atlassian bug CONFCLOUD-69848)

Expand

No

Content inside the macro will appear expanded.

Table

Yes

The table border and cell color are not visible.

Layouts / Sections

No

Will appear on top of each other.

Quote

Yes

 

Code snippet

Yes

Content is visible, but Confluence styling, line numbering, color highlighting, and copy button are not available.

Confluence's edit mode

Actual rendering in Pages2Tabs

Panel

  • Info

  • Note

  • Success

  • Warning

  • Error

Yes

Appears different compared to a normal page view.

Status

Yes

Appears different compared to the normal page view.

Divider

No

Appears as a short line.

Date

Yes

Date is visible, but lozenge is not.

Status

Yes

Appears different compared to the normal page view. Some colors are not displayed correctly due to the Atlassian bug CONFCLOUD-72377.

Decision

Yes

Appears different compared to the normal page view.

TOC

Yes

 

Excerpt include

Yes

Appears different compared to the normal page view.

Create from a template

No

 

Page properties

Yes

 

Page properties report

Yes

 

Jira Macros

Compatible

Notes

Jira issue macro - Single issue view

Yes

Appear as links.

Jira issue macro - Table view

Yes

 

Jira issue macro - Total issue count view

Yes

 

Jira Charts (Pie Chart)

No

 

Jira Charts (Created vs Resolved)

No

 

Jira Charts (Two dimensional)

Yes

 

Jira Roadmap

Yes

All mode displays as links.

Appfire macros

Compatible?

Notes

Other Composition macros (such as nesting another Pages to Tabs macro)

No

 

Visibility

  • Hide-If

  • Show-If

Yes

 

Others

  • Security & Encryption

  • Scaffolding

  • Linking

  • Redirection

  • Salesforce & Confluence Connector

No

 

Others

Compatible?

Notes

Other 3rd-party macros

No

 

Related pages

 

Need support? Create a request with our support team.

Copyright © 2005 - 2025 Appfire | All rights reserved.