Considering Confluence Cloud?
Get the high-level details of Confluence Cloud and available features by plan.
Insert the child pages macro
Use the child pages macro to insert a clickable list of pages nested under a given page. 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 display the child pages of the page you’re currently editing — but you can also select a different parent page when configuring the macro. The macro can display all levels of nested pages under whatever parent page is selected.
To add a list of child pages to your page:
From the editor, select from the toolbar or type / to bring up the insert menu.
Find the Child pages macro and select it. You can also type /childpages to select this macro from the insert menu right in the body of your page.
Upon selection, a list of child pages will appear in the body of your page if the selected page has children. If not, a guiding placeholder will appear.
When you preview your page or publish it, a frameless list will display.
The list and its page links are dynamic. If additional child pages are created or existing child page titles are edited, those changes will automatically be reflected in your list.
To configure your child pages macro:
While editing your page, select the Child pages macro you want to configure.
Select the Edit () icon to open the configuration panel.
Customize the parameters of your list of child pages via the Basic and/or Display tabs.
Your selections will take effect instantly.
You can also select the centered, medium-width, or full-width icon to adjust the width of your list. Select the copy icon to duplicate it elsewhere, and/or the trashcan icon to remove it entirely.
Basic and display parameters
You can customize exactly how your list of child pages appears on the page by configuring its Basic and/or Display parameters, depending on your needs and preference.
Basic parameter | Default | Description |
|---|---|---|
Parent page | Current page | Search and select the page from which you want to source your list of nested child pages. |
Show all child pages | On | Toggle on to display all child pages nested under a selected parent page, or toggle off to manually customize how many to display. |
Max number in list | 10 | When the Show all child pages toggle is off, this input field allows you to enter the number of child pages you want to display in your list. |
Show all levels | Off | Toggle on to display all levels of pages nested under a selected parent page, or toggle off to manually customize how many levels to display. |
Max number of levels | 1 level | When the Show all levels toggle is off, this input field allows you to select the number of levels of nested pages you want to display in your list, up to 9 levels. |
Display parameter | Default | Description |
|---|---|---|
Sort order | Current order in content tree | This dropdown allows you to configure the way your list of child pages is ordered.
|
List style | Bulleted | This dropdown allows you to customize the visual style of your list. You can display your list with bullets, or as headers ranging in size from H1 to H6. |
Display preview | None | This dropdown allows you to display your list with or without a preview of each child page’s content.
|
Was this helpful?
Still need help?
The Atlassian Community is here for you.