• Products
  • Documentation
  • Resources

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.

An animated gif of the new child pages macro configuration experience where a list of child pages can be added to a page.

To add a list of child pages to your page: 

  1. From the editor, select from the toolbar or type / to bring up the insert menu.

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

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

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

  1. While editing your page, select the Child pages macro you want to configure.

  2. Select the Edit () icon to open the configuration panel.

  3. Customize the parameters of your list of child pages via the Basic and/or Display tabs.

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

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 parameters

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.

  • Content tree - displays child pages in the order they appear in the sidebar, or reversed.

  • Title - displays child pages alphabetically by title, or reversed.

  • Created - displays child pages in order from most recently created to least, or vice versa.

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.

  • Page preview - displays a snapshot of the top section of a page’s content, including formatted text, images, and certain macros.

  • Excerpt preview - displays the first line of text contained in an Excerpt macro on any listed child pages. If there isn’t an excerpt on the page, nothing will be shown.

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 {children:reverse=true|sort=creation|style=h4|page=Home|excerpt=none|first=99|depth=2|all=true}

 

Additional Help