Task Report Macro

Still need help?

The Atlassian Community is here for you.

Ask the community

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 Format in Confluence for more information on creating and assigning tasks. You can also use the Task Report blueprint template, 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:

  1. In the Confluence editor, choose Insert > Other Macros
  2. Find and select the required macro

Speeding up macro entry with autocomplete: Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Keyboard Shortcuts, Markdown, and Autocomplete.

To edit an existing macro: Click the macro placeholder and choose Edit. A macro dialog window will open, where you can edit the parameters of the macro.

On this page:


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


Parameters are options that you can set to control the content or format of the macro output. 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).





Space(s) and Page(s)
No None Filter 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.
No None

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
No None Filter by Assignee. The macro will only display tasks assigned to the users specified.  
Created by
No None Filter by Creator. The macro will only display tasks created by the users specified.
Created after
No None Filter 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
Yes Incomplete Show complete or incomplete tasks.

Number of tasks to display

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

Sort tasks by due date, assignee or page title.

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

Wiki markup example

Wiki markup is not available for this macro. You cannot add this macro via wiki markup.

Last modified on Sep 15, 2017

Was this helpful?

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