Set up Confluence Cloud
Get the high-level details you need to set up your Confluence Cloud site in order to meet your team's needs.
Insert the children display macro
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).
Parameter | Default | Description |
|---|---|---|
Show Descendants | not selected | 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. |
Parent Page | current page | 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 | no limit | 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. |
Heading Style | none (bullets) | 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. |
Excerpt Display | none | 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 | Optional. Choose:
|
Reverse Sort | false | 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.
1
2
3
4
{children:reverse=true|sort=creation|style=h4|page=Home|excerpt=none|first=99|depth=2|all=true}
Was this helpful?