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.
The following table provides details about the options in the first step of the macro editor.
Name | Required | Default Value | Description |
---|---|---|---|
Source | Yes | Parent page | Can be:
|
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.
You can:
Edit the tab titles. You cannot edit the tab content, as it automatically loads from the source pages.
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 |
---|---|---|---|
Tab position | Specify where the tabs are positioned on the page. |
| Top |
Tab style | Choose the visual theme for your tabs. |
| Default |
Tab font size | Adjust the size of the text on the tabs. |
| Small |
Tabs color | Customize the colors for active and inactive tabs. | First line: Active tab colors | Dark blue (Active 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 |
---|---|---|
Fonts
| Yes |
|
Text alignment | Yes |
|
Lists
| Yes |
|
Check List | No | Appear as bullet points. |
Links | Yes | All modes (URL, card, inline) will display as URL. |
Files & Images | Yes |
|
Mentions | Yes |
|
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
| 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
| Yes |
|
Others
| 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.