Selecting pages to be rendered as Tabs

Owned by Elizabeth Tai (Unlicensed)
Last updated: Jun 03, 2024 by Karina Zoin
4 min read

The Pages to Tabs macro can:

  • render all children pages of a selected parent page as tabs

  • render any selected pages as tabs

This macro also displays children pages dynamically, which means if the children pages are edited, the changes will be reflected in the tabs.

Without this macro, you would need to create a new Tabs macro, then copy and paste content from other pages into the new tabs. This pasted content would not be dynamically updated.

The Pages to Tabs macro functions quite similarly to Confluence's Page include macro, but works around the limitations of these macros which currently cannot be nested within other macros in Confluence Cloud.

Ingredients

Apps

Composition

Macros

Pages to Tabs

Guide

Rendering children pages of selected parent page as tabs

In this example, we will insert a Pages to Tabs macro in a page and use it to display all children pages of a selected parent page as tabs.

  1. Insert a Pages to Tabs macro via the macro browser, or use the keyboard shortcut ( "/" for new editor or "{" for old editor)

  2. The Insert Pages to Tabs Macro popup will appear. In the Source section, select Parent page from the dropdown. 


  3. In the Parent page section, select a page to use as the parent page, or leave it blank to use the current page (default). This page should have a number of children pages that you want to display as tabs.

  4. Click Next to continue. The macro will appear in the editor, with the children page titles. You can edit the tab names with a custom name and choose the tab's position. 

  5. Click Insert again to see the final results.

Rendering selected pages as tabs

This example is very similar to the one above, except in this case, the selected pages are located in different spaces.

  1. Insert a Pages to Tabs macro via the macro browser, or use the keyboard shortcut ( "/" for new editor or "{" for old editor).

  2. The Insert Pages to Tabs Macro popup will appear. In the Source section, select Page selector from the dropdown.

  3. In the Page selector section, select pages that you want to display as tabs from the dropdown list. You can also type in keywords in the box to filter page names.



  4. Click Save to continue. The macro will appear on the editor, with the children page titles. You can edit the tab names with a custom name and choose the tab's position. 

  5. Click Save again to see the final results. 

Notes

The following table lists which content or macros are supported within a Pages to Tabs macro. Note that the list below may 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 appears 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 macro will appear expanded.

Table

Yes

Table border and cell color is 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

  1. Info

  2. Note

  3. Success

  4. Warning

  5. Error

Yes

Appear different compared to normal page view.

Status

Yes

Appear different compared to normal page view.

Divider

No

Appear as short line.

Date

Yes

Date is visible, but lozenge is not.

Status

Yes

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

Decision

Yes

Appear different compared to normal page view.

TOC

Yes



Excerpt include

Yes

Appear different compared to normal page view.

Create from template

No



Page properties

Yes



Page properties report

Yes



Jira Macros

Compatible

Notes

Jira issue macro - Single issue view

Yes

Will 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 will display as links.

ServiceRocket 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



Â