Selecting pages to be rendered as Tabs with Composition Cloud

This guide focuses on using the Pages to Tabs macro which is only available in the Cloud version. For Server, use the Card and Deck of Cards macros instead.

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
Platform
Cloud
Macros
Suppliers

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.

    IMPORTANT

    • Each macro can render a maximum of 25 children pages as tabs. 
    • Only the first level of children pages are rendered. That is, children of children pages will not be rendered.
  4. Click Insert to continue. The macro will appear on the page, with the children page titles. Click Publish 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 Insert to continue. The macro will appear on the page, with the selected page titles. Click Publish 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/MacroCompatibleNotes
Fonts
  • Normal text
  • Heading 1, 2, 3, 4, 5, 6
  • Bold, italic, underline
  • Strikethrough
  • Code
  • Superscript, subscript
  • Text color
Yes


Text alignmentYes
Lists
  • Bullet
  • Numbered
Yes
Check ListNoAppear as bullet points
LinksYesAll modes (URL, card, inline) will display as URL
Files & ImagesYes
  • Base64 encoded PNG are not supported
  • Invalid files or images appears with different styling
MentionsYesAppear as working links without lozenge styling
EmojisYesSome emojis are displayed as a blue star. (This is an Atlassian bug CONFCLOUD-69848)
ExpandNoContent inside macro will appear expanded
TableYesTable border and cell color is not visible
Layouts / SectionsNoWill appear on top of each other
QuoteYes
Code snippetYes

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

    Panel
    1. Info
    2. Note
    3. Success
    4. Warning
    5. Error
    YesAppear different compared to normal page view
    StatusYesAppear different compared to normal page view
    DividerNoAppear as short line
    DateYesDate is visible, but lozenge is not
    StatusYes

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

    DecisionYesAppear different compared to normal page view
    TOCYes
    Excerpt includeYesAppear different compared to normal page view
    Create from templateNo
    Page propertiesYes
    Page properties reportYes
    Jira MacrosCompatibleNotes
    Jira issue macro - Single issue viewYesWill appear as links
    Jira issue macro - Table viewYes
    Jira issue macro - Total issue count viewYes
    Jira Charts (Pie Chart)No
    Jira Charts (Created vs Resolved)No
    Jira Charts (Two dimensional)Yes
    Jira RoadmapYesAll mode will display as links
    ServiceRocket macrosCompatible?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
    OthersCompatible?Notes
    Other 3rd party macrosNo


    Result