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

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.

Using the Task Report macro

To add the Content Report Table macro to a page:

On this page:

Related pages:

Task Report macro showing incomplete tasks, on pages with the label 'meeting-notes'.


Parameters

Parameter

Required

Default

Description

Space(s) and Page(s)
(spaceAndPage) 		NoNoneFilter by the task location. The macro will only display tasks in the pages or spaces 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 this label. You can 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.

Code examples

The following examples are provided for advanced users who want to inspect or edit the underlying markup for a Confluence page. 

Macro name: tasks-report-macro

Macro body: None.

Storage format example

Note: The spaceAndPage multi-picker parameter populates the spaces and pages parameters. 

        <ac:structured-macro ac:name="tasks-report-macro">
          <ac:parameter ac:name="spaces">BSP</ac:parameter>
          <ac:parameter ac:name="status">complete</ac:parameter>
          <ac:parameter ac:name="assignees">
            <ri:user ri:userkey="2c9682654373c47f014373caa68a0003"/>
          </ac:parameter>
          <ac:parameter ac:name="spaceAndPage">space:BSP,page:2555905</ac:parameter>
          <ac:parameter ac:name="pages">2555905</ac:parameter>
          <ac:parameter ac:name="labels">meeting-notes</ac:parameter>
          <ac:parameter ac:name="pageSize">10</ac:parameter>
        </ac:structured-macro>

Wiki markup