Task Report Macro

Add the Task Report macro to a page to display a list of tasks. Filter the tasks by space, page, user, label, created date and more.

This macro is great for:

  • meeting notes
  • status reports
  • project planning pages.

See Add, Assign, and View Tasks for more information on creating and assigning tasks. You can also use the Task Report blueprint, which will create a page and add this macro for you.

On this page:

Related pages:

Screenshot: The Task Report macro showing incomplete tasks on a meeting notes page.

Add this macro to your page

To add the Task Report macro to a page:

  1. From the editor toolbar, choose Insert > Other Macros.
  2. Choose Task Report from the Confluence content category.
  3. Enter any parameters.
  4. Choose Insert

You can then publish your page to see the macro in action. 

Screenshot: Configuring the Task Report macro to show tasks from a specific space.

Change the macro parameters

Macro parameters are used to change the behaviour of a macro.

To change the macro parameters:

  1. In the editor, click the macro placeholder and choose Edit.
  2. Update the parameters as required then choose Insert.

Here's a list of the parameters available in this macro. 





Space(s) and Page(s)
NoNoneFilter by the task location. The macro will only display tasks in the spaces or parent pages (and their child pages) specified. You can enter a combination of spaces and pages.

Filter by Label. The macro will only display tasks on pages with at least one of the specified labels (for example, 'label-a' OR 'label-b'). Enter multiple labels, separated by a comma.

Assigned to
NoNoneFilter by Assignee. The macro will only display tasks assigned to the users specified.  
Created by
NoNoneFilter by Creator. The macro will only display tasks created by the users specified.
Created after
NoNoneFilter by created date. The macro will only display tasks created on or after the date specified. Date must be entered as dd-mm-yyyy.
Task status
YesIncompleteShow complete or incomplete tasks.

Number of tasks to display

No20The number of tasks to display on each page of results in the table. Choose from 10, 20 or 40.
Display columns
Nodescription,duedate, assignee,locationColumns to include in the table. Available columns include description, duedate, assignee, location, completedate and labels.
Sort by
NoDue date

Sort tasks by due date, assignee or page title.

Select the Reverse Sort check box to sort the table in reverse order.

Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the macro browser, it will be listed below in brackets (example).

Other ways to add this macro

Add this macro as you type

Type followed by the start of the macro name, to see a list of macros. 

Add this macro using wiki markup

You can't use wiki markup to add this macro.

Last modified on Feb 8, 2024

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.