12 Days of Confluence Elements: Day 10 - Children Display macro
Use the Children Display macro to insert a list of a page’s child pages, and their descendants. People viewing the page will only see the links for pages they have permission to view.
By default, the list will show the child pages of the page the macro is on — but you can also select a different parent page when configuring the parameters. The macro can display the child and descendant pages of whatever parent page is specified.
When would you use Children Display macro?
This is useful, for example, if you want to create navigation links on a parent page to its nested pages.
Where is this used in our instance?
You can find Children Display macros on section landing pages such as Graduation & Commencement under “In this section”.
Add the Children Display macro
To insert a macro:
When editing, select Insert from the toolbar
Find the macro by name and select it
Configure it as needed
You can also type / on the page to bring up the same list you'd see by selecting from the toolbar. Continue typing the name of the macro to filter the list.
To edit a macro:
Select the macro placeholder.
Select the Edit icon to open the configuration panel.
Configure the parameters. Your changes are saved as you go.
Resume editing the page, and the panel closes.
You can also select the centered , medium-width , and full-width icons to adjust the width of some macros. Select the trashcan icon to remove the macro.
The page links are dynamic — if additional child pages are published or the page titles are edited, those changes will automatically be reflected in the list.
Configure the parameters
Parameters are options that you can set to control what and how content from the macro appears on the page.
If the parameter name used in Confluence Cloud storage format or wikimarkup is different than the label used when inserting macros using the browser or the slash command, it will be listed below in brackets (example).