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.

9 answers

1 accepted

It's the Reporting Plugin from Customware:

http://wiki.customware.net/repository/display/AtlassianPlugins/Reporting+Plugin

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}

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 -- https://jira.atlassian.com/browse/CONF-11535 -- similar but not quite right. Does anyone know there is an Enhancement Request? I will happily vote for it.

Suggest an answer

Log in or Sign up to answer
How to earn badges on the Atlassian Community

How to earn badges on the Atlassian Community

Badges are a great way to show off community activity, whether you’re a newbie or a Champion.

Learn more
Community showcase
Posted Jul 10, 2018 in Confluence

We want to see the templates you've created in Confluence!

Hi Community, Jessica here from the Confluence Product Marketing team!  July’s community challenge is all about sharing pictures  — and as an extension of our first post on what ...

606 views 20 11
Join discussion

Atlassian User Groups

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

Find a group

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

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you