Dashboard > Confluence User Guides and Documents > ... > Working with Macros > Children Display Macro
Children Display Macro Log In   View a printable version of the current page.

Added by vidya, last edited by rosie@atlassian.com on Jun 18, 2007  (view change)
Labels: 
(None)

Use the Children Display Macro to display the children and the descendants of a page.

Note that only pages to which you have 'View' permission will be displayed.

Children Display Macro

What you need to type What you will get
Unknown macro: {nomarkup}

Optional Parameters

No  parameter Default Description
 1 all true Display all descendants
 2 page current Specify which page to display children for in a current space or in a different space
 3 depth none Specify the depth of descendents to display
 4 first none Restrict the number of children displayed at the top level
 5 style none Specify the style in which descendants are displayed
 6 excerpt false Display the child pages' excerpts, if they exist
  7 sort=creation
sort=title
sort=modification
recent The 'sort' attribute is an optional attribute that allows you to configure how the children are sorted. Specify 'creation' to sort by content creation date, 'title' to sort alphabetically on title and 'modified' to sort of last modification date.

1. Display all descendants of the page

{children:all=true}{nomarkup}

2a. Specify which page to display children for

{children:page=page name}

2b. Specify which page in a different space to display children for

{children:page=space key:page name}

3. Specify the depth of descendants

{children:depth=2}

4. Restrict the number of children displayed at the top level

{children:first=x}

5. Specify the style in which descendants are displayed

Choose from heading levels h1 to h6.

{children:depth=1|style=h3}

6. Display the child pages' excerpts, if they exist

{children:depth=2|excerpt=true}

7. Sort children by creation date, modification date or title

{children|sort=creation|reverse=true}

If the page parameter is '/', then the macro will list all the current space's "top level" pages - those without parents. If the page parameter is a space key followed by a
colon (e.g {children:page=DOC:}), then the top level pages of that space will be listed.

RELATED TOPICS

Working with Page Families
Working with Macros

Take me back to [Confluence 2 User Guide]

DEMONSTRATION LICENSE - This Confluence site is for demonstration purposes only. Evaluate Confluence today.
Powered by Atlassian Confluence, the Enterprise Wiki. (Version: 2.6.1 Build:#916 Nov 09, 2007) - Bug/feature request - Contact Administrators