Selecting pages to be rendered as Tabs

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

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

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.