Get the high-level details you need to set up your Confluence Cloud site in order to meet your team's needs.
Learn how to create great content and organize it.
Learn how to collaborate on pages and blogs, get notified about activity, and view analytics to see how content is performing.
Adjust settings around who can see what content on your site and what actions they can perform on it.
Find everything a site admin needs to know to keep their Confluence Cloud site running smoothly.
Get an overview of the macros and premium features that extend Confluence functionality.
Use the Children Display macro to insert a list of a page’s child pages, and their descendants. This is useful, for example, if you want to create navigation links on a parent page to its nested pages. 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.
Add the Children Display macro
To insert a macro:
When editing, select 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 iconto 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).
Select this if you want to display all of a page’s children and their descendants.
Links to all the nested pages will be shown, without needing to specify the Depth of Descendants.
If the page you’re on is the parent of the pages you want to list, you can leave this field empty.
But the macro can display child and descendant pages of whatever parent page is specified.
Type to search for a page, by name, from any space. You can also try typing these shortcuts:
Number of Children
This field limits the number of children shown. Leave it empty if you want to show all child pages.
If you have a particularly long list, you can shorten it by entering the exact number of child pages to display.
Descendants of any child pages shown will still be displayed, if you’ve set the Depth of Descendants to include them.
Depth of Descendants
only child pages
This field controls whether to include the child page’s descendants, and if so, how many levels.
If you only want to show the parent’s child pages, either leave it empty, or enter the number 1 to specify one level of page descendants.
Enter the number 2 to specify two levels of page descendants (child, grandchild). And so on.
If you leave this field empty, the pages default to a bulleted list.
If you’d like the child pages to be formatted as headings, select a heading level.
This is also a way to increase the font size. Descendants of child pages, however, will still show up as indented bullets in the normal size and style of text.
If you only want to show page title links, leave this set to “none”.
But you also have the option to include a page preview under each page in the list:
Sort Children By
Manual if manually ordered, otherwise alphabetical
Use with the Sort Children By parameter. When set, the sort order changes from ascending to descending.
Wiki markup example
Wiki markup is only supported in the legacy editor.
Wiki markup is useful when you need to add a macro outside the editor, for example as custom content in the sidebar, header or footer of a space.
Macro name: children
Macro body: None.
Was this helpful?