Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

How do I restrict child pages listed by the Children Display macro to those with a specific label?

I have a bunch of parent pages where I want to list the child pages of each, but I want to have a separate list for each label.

The Children Display macro produces the output I want, but it doesn't have a parameter to specify a label. There may be a parameter that isn't shown in the dialog but I don't know how to get to the old markup syntax.

12 answers

1 accepted

1 vote
Answer accepted

It's the Reporting Plugin from Customware:

I've used it in this markup to produce a bulleted list of titles of pages that contain the specified label:

{report-list} {local-reporter:content:children|source=PAGE TITLE} {text-sort:content:title} {content-filter:@self|labels=+LABEL} {local-reporter} {report-body}{report-info:content:title|link=true}{report-body} {report-list}

I've also used the following markup to produce a page that includes the full wiki pages (rather than just titles) of those children pages that contain the specified label(s):

{report-list} {local-reporter:content:children|source=PAGE TITLE} {text-sort:data:Author} {content-filter:@self|labels=+LABEL,+LABEL2} {local-reporter} {report-body}{report-info:content:body|render=wiki}{report-body} {report-empty}_There are no reports this week._{report-empty}{report-list}

It can also be used to produce a list of children that contain one label OR another label - the example below will produce any children that contain LABEL1 AND either LABEL2 or LABEL3:

{report-list} {local-reporter:content:children|source=PAGE TITLE} {text-sort:data:Author} {content-filter:@self|labels=+LABEL1,+(LABEL2,LABEL3)} {local-reporter} {report-body}{report-info:content:body|render=wiki}{report-body} {report-empty}_There are no reports this week._{report-empty}{report-list}

Hope that helps!


I am by no means a developer, but this piece of code does exactly this. You can modify it to show the links too.

## @param noShowLabel:title=Label|type=string|desc=Label of pages to exclude

#macro(childrenList $parentPage)
#set($childpagesSub = $parentPage.getSortedChildren())
#set($childrenN = $childpagesSub.size())
#if($childrenN > 0)
#foreach($page in $childpagesSub)
#set($pageLabels = $page.getLabels())
#foreach($pageLabel in $pageLabels)
#if($pageLabel == $paramnoShowLabel)


would it be possible to manipulate the result of the Children Display Macro using JaveScript in the HTML Macro?

May these sources could help to find a solution:

Anyone there who can asses this and tell whether that could be done?

insert CQL Search macro with: label=<label> AND parent=<parentID>

But you get list of pages and space, no excerpt.

Do you create this in User Macro? If so can you give all the details on how you did it? So we can recreate it.

I searched the Confluence JIRA project and found this Feature Enhancment -- -- similar but not quite right. Does anyone know there is an Enhancement Request? I will happily vote for it.

Ok, thanks for the reply.

No, there's no easy way to filter a list of child pages by label. I've worked around it by listing all child pages with excerpts, so people can work out what they relate to without a label.

Hi, did you find a solution? I have the same issue.

Those macros don't work in my Confluence. :(

What plug-in is that? What does the rendered list look like?

Not sure if this is exactly what you're looking for but I've used this to list a page's children pages with the label foo:

{report-list} {local-reporter:content:children} {text-sort:content:title} {content-filter:@self|labels=+foo} {local-reporter} {report-body}{report-info:content:title|link=true}{report-body} {report-list}

where did you use this? In the HTML Macro?

I tried the Checklist macro which can be restricted to child pages with a label, but the excerpt is not rendered properly (you can see HTML mark-up as plain text) and it's a table rather than a bullet list.

Hi, I have been looking for the same. All I found ware following approaches : a) Using the page family tree plugin from adaptavist - beware, it has a performance-issue, wether it will work for you depends on the sice of the pagetree b) Using "content by label" in combination with pagetree-unique labels ( :-( ) c) (Maybe, just had the idea) Search macro with "ancestor-ID = XXXX and <tagname>" Let us know how you solved this. Josh

I tried the Advanced search macro (had to enter as wiki input because the forms don't allow mandatory fields to be entered) but I can't get the excerpts.

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Confluence

Confluence Mythbusters: Does Atlassian even use Confluence?

Hi, Confluence collaborators! As part of #Confluence-Collaboratory month, we’ve created a very special Mythsbusters segment, where we're dive into an interesting myth and uncover the truth behind i...

1,635 views 7 30
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you