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 can I make the taskreport reference to <current page>

This question is in reference to Atlassian Documentation: Task Report Macro

How can I restrict the task report to summazire only those tasks, listed on the same page as the macro is - when I do not know the pagename yet - e.g. for templates or code snippets.

With other macros, there is a placeholder "@self" or "@localspace" available.


3 answers

1 accepted

5 votes
Answer accepted

Here is what I would do. You will need the Confluence Source Editor. It is free and made by Atlassian. First add a task report macro to your page and set it up the way you want without the page ... we'll get to that in a sec.

image2016-8-4 11:7:45.png

Then open up the source of the page(top right corner of the editor) to grab the storage format for the macro.

image2016-8-4 11:8:44.png

image2016-8-4 11:9:27.png

Select the macro storage format and copy it. The highlighted part in the above image is the page parameter and we are going to create a user macro that will implement the built-in task report macro but will dynamically swap out the page parameter.

Go to Confluence Admin -> User Macros and create a new one. The below user macro definition is based on what you see above. If you want more of the report macro parameters set a certain way then do that before you copy the storage format for creating your user macro ... again we are just going to switch out that one "pages" parameter.

Page Task Report Macro

Macro Name

Macro Title
Page Task Report 

Whatever you want 

Macro Body Processing
No macro body 


## Developed by: Davin Studer
## Date created: 08/04/2016
## @noparams
<ac:structured-macro ac:name="tasks-report-macro">
    <ac:parameter ac:name="pages">$</ac:parameter>
    <ac:parameter ac:name="labels">Stuff</ac:parameter>


You now have a macro that you can drop into your templates.

Sounds cool - and thanks for your effort to make it a tutorial :smile:

Agree with Martin. This does not seem like a solution to the obvious need.

Davin_Studer Community Leader Oct 30, 2018

Currently, you cannot point the task report macro at the current page. This allows you to create a wrapper around the built-in task report macro that will dynamically put in the page id for you ... effectively giving you the ability to point it at the current page. It may not be the ideal but it allows you get that functionality now instead of having to wait for it to be natively implemented.

Thanks for your quick response, Davin. Sorry about the way I expressed myself. My comment was aimed at Atlassian. To have to save the page I created and then search for that page is tedious when it should be straightforward. I created a template that includes a Task List for that page and would love to see that be able to reference <self> or something like that.

I don't have macro privs, so I can't implement your solution. 

Hey Davin - thanks for the instructions, it helped me a lot :)

(removed description of the problem - as I managed to solve it)

It just works, my mistake. Thanks again!


Hi Davin,

Many thanks for your help. The Confluence Source Editor sure is a great tool for this purpose.

Cheers !

Hi Davin,

I'm trying to implement your solution but whitout success.

Firstly, I cannot see user macro in macro menu. That's strange!

Secondly, if I try to copy/paste source code block directly on page to switch out that one "pages" parameter I got error about

If i replace through source editor by page Id value (get from page information URL) it works.

I certainly missed something.

Attached my macro definition, source editor block which works and error message if I put $ in source editor.

All help is welcome.



Davin_Studer Community Leader Mar 08, 2019

In your user macro definition change the Macro Name to something other than tasks-report-macro. That is the built-in macro and we are creating a macro that wraps around it so it needs a different name than the built-in one.

Hi Davin, thanks for your time.

Unfortunately changing name of macro does not solved issue. I have replace macro name by customizedtaskreporting.

I 'm still not able to see macro using UI menu or Keyboad shortcut '[ '


Davin_Studer Community Leader Mar 08, 2019

So the macro browser keyboard shortcut is '{' not '['. Was that just a typo or are you using the wrong shortcut?

After you save the user macro you may need to refresh your page as the macro names are cached. Once you've refreshed the page and clicked edit if you type '{' and then start typing customizedtaskreporting it should show.

Hi Davin,


It's a nightmare. I already created macro in the past. I don't understand why I still cannot see macro in menu or using shortcut after having refreshed page.


Is there an easier way to do this?

Suggest an answer

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

What project did you transition or start on Confluence with the shift to remote work?

It’s been great to hear from fellow users over the last few weeks about the best tips and fun moments you’ve had working on Confluence since the transition to working remote. I’d love to keep the c...

109 views 3 7
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