• Products
  • Documentation
  • Resources

Insert the task report macro

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.

Use the Task Report macro

To add the Content Report Table macro:

  1. When editing, select from the toolbar

  2. Find the macro by name and select it

  3. Configure it as needed

You can also type / on the page to bring up the same list you'd see by selecting from the toolbar. Continue typing the name of the macro to filter the list.

To edit the Content Report Table macro:

  1. Select the macro placeholder.

  2. Select the Edit icon to open the configuration panel.

  3. Configure the parameters. Your changes are saved as you go.

  4. Resume editing the page, and the panel closes.

You can also select the centered , medium-width , and full-width icons to adjust the width of some macros. Select the trashcan iconto remove the macro.

Parameters

Parameters are options that you can set to control what and how content from the macro appears on the page. 

If the parameter name used in Confluence Cloud storage format is different than the label used when inserting macros using the browser or the slash command, it will be listed below in brackets (example).

Parameter

Req'd

Default

Description

Space(s) and Page(s)
(spaceAndPage

Yes

Space where the page was created

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.

Label(s)
(labels

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
(assignee

No

None

Filter by Assignee. The macro will only display tasks assigned to the users specified.  

Created by
(creator)

No

None

Filter by Creator. The macro will only display tasks created by the users specified.

Created after
(createddateFrom

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
(status

Yes

Incomplete

Show complete or incomplete tasks.

Number of tasks to display
(pageSize

No

20

The number of tasks to display on each page of results in the table. Choose from 10, 20 or 40.

Display columns
(columns

No

description, duedate, assignee, location

Columns to include in the table. Available columns include description, duedate, assignee, location, completedate and labels.

Sort by
(sortBy)
 

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 can’t add this macro via wiki markup.

 

Still need help?

The Atlassian Community is here for you.