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. Unable to render {include} The included page could not be found.
  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

Error rendering macro 'excerpt-include'

User 'null' does not have permission to view the page.

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

Parameter

Required

Default

Description

Space(s) and Page(s)
(spaceAndPage
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.
Label(s)
(labels
NoNone

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
(assignee
NoNoneFilter by Assignee. The macro will only display tasks assigned to the users specified.  
Created by
(creator)
NoNoneFilter by Creator. The macro will only display tasks created by the users specified.
Created after
(createddateFrom
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
(status
YesIncompleteShow complete or incomplete tasks.

Number of tasks to display
(pageSize

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

Sort tasks by due date, assignee or page title.

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

Error rendering macro 'excerpt-include'

User 'null' does not have permission to view the page.

Other ways to add this macro

Add this macro as you type

Unable to render {include} The included page could not be found.

Add this macro using wiki markup

Unable to render {include} The included page could not be found.

Last modified on Dec 15, 2021

Was this helpful?

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