Is there a way to narrow down the pages pulled by "Insert Confluence List" macro to just child pages

[Myleen Bacarra]

Is there a way to narrow down the pages pulled by "Insert Confluence List" macro to just child pages?

[Marshall Walker Lee]

Here's how you typically do it, depending on your Confluence version (Cloud vs. Server/Data Center) and the specific macro options available:

Key Concept: Specifying the Parent Page

The core of this is telling the macro which page to consider as the parent.

Common Methods:

1. Using the "Parent Page" or "Root Page" Parameter:

   • When you insert the "Insert Confluence List" macro, look for a parameter like "Parent page", "Root page", or "Ancestor".
   • In this field, you would type or select the name of the page whose children you want to display.
   • This is the most direct way to achieve your goal.

2. Using "Current Page as Root" or Similar Option:

   • Many versions of this macro have an option (often a checkbox) to "Use current page as root" or "Display child pages of current page."
   • If you enable this, the macro will automatically list the child pages of the page where the macro is placed. This is very convenient for navigation sections on parent pages.

3. Filtering by Space (Optional but useful for context):

   • While not directly for child pages, you can often filter the list to a specific Confluence space. This helps ensure you're only pulling pages from the relevant area before you apply the child page filter.

Steps (General for Confluence Cloud):

1. Edit your Confluence page.
2. Type / and then start typing "Confluence List" (or "Content by Confluence List" or "List of pages"). Select the appropriate macro from the suggestions.
3. The macro editor will open.
4. Look for the "Root page" field. This is where you specify the parent.
   • To list children of another specific page: Start typing the name of that parent page, and Confluence will suggest matching pages. Select the correct one.
   • To list children of the current page: In some versions, you might leave "Root page" blank and check a box like "Display children of current page" or select "Current Page" from a dropdown. In others, you might simply type the name of the current page into "Root page."
5. Adjust other parameters as needed:
   • "Levels to display": This is crucial. If you only want direct children, set this to 1. If you want children, grandchildren, etc., increase the number (e.g., 2, 3, or All).
   • "Order by": How you want the list sorted (e.g., Title, Creation Date).
   • "Reverse order": Whether to sort ascending or descending.
   • "Include content from": You can specify spaces here if you're pulling from multiple spaces.
   • "Filter by label": You can further narrow down pages by specific labels.
   • "Columns": What information you want to display for each page (e.g., Title, Creator, Last Modified Date).
6. Click "Insert" or "Save" (depending on the editor).