Insert the child items macro
Use the child items macro to insert a clickable list of pages and live docs that are nested under a given parent item. This is useful, for example, if you want to create navigation links on a parent page or doc to its nested content. People viewing the list will only see the links for content they have permission to view.
By default, the list will display the child items of the content you’re currently editing — but you can also select a different parent item when configuring the macro. The macro can display all levels of nested items under whatever parent is selected.
To add a list of child items to your page or live doc:
From the editor, select or type
/to bring up the insert menu.Find the Child items macro and select it. You can also type
/childitemsto select this macro from the insert menu right in the body of your content.Upon selection, a list of child items will appear in the body of your content if the selected parent has children. If not, a guiding placeholder will appear.
The list and its links are dynamic. If additional child items are created or existing child item titles are edited, those changes will automatically be reflected in your list.
To configure your child items macro:
While editing your page, select the Child items macro you want to configure.
Select the Edit () icon to open the configuration panel.
Customize the parameters of your list of child items 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 items appears on the page by configuring its Basic and Display parameters, depending on your needs and preference.
Basic parameter | Default | Description |
|---|---|---|
Parent item | Current page or live doc | Search and select the page from which you want to source your list of nested child pages. |
Show all child items | 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 items 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 item’s content.
|
Was this helpful?