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
{children}

Optional Parameters

Display all descendants of the page

What you need to type

What you will get
{children:all=true}



Specify the page for which you want to display children

What you need to type

What you will get
{children:page=children display macro}



Specify the depth of descendants

What you need to type

What you will get
{children:depth=2}



Specify the style in which descendants are displayed

Choose from heading levels h1 to h6.

What you need to type

What you will get
{children:depth=1|style=h3}

Child Page 1

Child Page 2



Display the child pages' excerpts, if they exist

What you need to type

What you will get
{children:depth=2|excerpt=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 Help Home

  • No labels

6 Comments

  1. Vidya Madabushi

    Aug 25, 2005

    Dummy excerpts for the two child pages...

  2. Laks Krishnamoorthy

    Feb 20, 2006

    Vidya,

    Where do I change the order of page display to display by title in every page in our confluence instance.

    Thanks

    Laks

     `

    1. user-93ab0

      Feb 21, 2006

      I'll fill in some other missing info from this page then answer your question...

      There are three sort orders:

      • title (alphabetical, but gets confused by numbers)
      • created (date)
      • modified (date)
      {children:sort=title}
{children:sort=created}
{children:sort=modified}

      You can also reverse the sort:

      {children:sort=title|reverse=true}
etc..

      Sadly, there is currently no way to set a specific order for pages. The closest you can get is to number them like:

      1. Whatever
      2. Whatever
      3. Whatever

      The only problem is that this only works for 10 pages (0-9) – once you get over that, problems occur, eg:

      1. Whatever
      10. Oh dear
      2. Whatever
      etc

      Adaptavist are working on an updated page tree plugin that might solve that number sorting issue, but it's still a shame that pages can't be given a specific order.

  3. Laks Krishnamoorthy

    Feb 21, 2006

    Guy,

     Thanks. What I want is to change the order of the children listed below on every page to be sorted by title. This is the listing of all children below the that says

    Children   Hide Children | View in hierarchy | Add Child Page

    Thanks

    Laks

  4. Nana

    Apr 13, 2007

    Is there a Parent macro to display parents on child pages?. Its only fair that there should be.

  5. raf raf

    May 09, 2007

    Is there a marco to list the incoming links of a page and of all of it's children page ? Something like a combination of the children macro and eht incoming-links macro ? Thanks for advice