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

Next challenges

Recent achievements

  • Global
  • Personal


  • Give kudos
  • Received
  • Given


  • Global

Trophy case

Kudos (beta program)

Kudos logo

You've been invited into the Kudos (beta program) private group. Chat with others in the program, or give feedback to Atlassian.

View group

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.

11 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!

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.

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.

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?

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

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

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

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.

Ok, thanks for the reply.

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.

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.

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?

Suggest an answer

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

What do you think is the most *delightful* Confluence feature? Comment for a prize!

- Create your own custom emoji 🔥 - "Shake for Feedback" on mobile 📱 - An endless supply of GIFs via GIPHY 🤩 Is there anything quite as nice as a pleasant surprise? Comment below with what...

463 views 24 9
Join discussion

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