Confluence tasks cheat sheet
Confluence tasks (also called action items) are checkboxes you can assign to someone and give a due date. Here's every way to create and manage them in Confluence Cloud, where they show up, and every setting of the built-in Task report macro, on one page you can print.
Create a task
| Type or choose | What you get |
|---|---|
[] then a space | A new task on its own line. Keep typing to describe it. |
/ then Action item | The same, from the insert menu. Type the first few letters to filter it. |
| Action item on the toolbar | The same, with the mouse. |
<> then a space | A decision, not a task: it has no checkbox and doesn't appear in task lists or reports. |
Assign it and give it a due date
| Inside the task, type | What happens |
|---|---|
@ and a name | Assigns the task. They get a notification, and an email if they're subscribed to them. Only the first mention of someone on a page notifies them; mentioning them again on the same page doesn't. During a Confluence trial, people get the notification but no email. |
@ and a team | Notifies the team's members, for teams of 50 people or fewer. |
/ then Date | Adds a date, which becomes the task's due date. Once it has passed, the date shows in red. |
@ and a Rovo agent | Opens Rovo Chat with the task's text as the prompt (where Rovo is switched on). |
Finish it
- Tick the checkbox to mark the task complete. Ticking a task changes the page, so it needs permission to edit that page.
- No reminders. Confluence doesn't notify anyone when a due date arrives or passes (CONFCLOUD-35150). See how to send a weekly reminder for what you can do instead.
Where tasks show up
| Where | What it shows | More |
|---|---|---|
| On the page itself | The task, its assignee and its due date | |
| Your Tasks list (profile picture, top right, then Tasks) | Tasks assigned to you, across the site | Guide |
| A Task report macro on a page | Tasks from the spaces and pages you list, filtered by the settings below | Guide |
Task report macro settings
Edit a page, type /task report and choose Task report. Its settings, as Atlassian lists them:
| Setting | What it does | Default |
|---|---|---|
| Space(s) and Page(s) (required) | Only tasks in the spaces, pages and live docs you enter. You can mix spaces and pages. | The space the page is in |
| Label(s) | Only tasks on pages with these labels (comma-separated) | None |
| Assigned to | Only tasks assigned to these people | Anyone |
| Created by | Only tasks created by these people | Anyone |
| Created after | Only tasks created on or after this date, written dd-mm-yyyy | None |
| Task status (required) | Complete or incomplete tasks | Incomplete |
| Number of tasks to display | Rows per page of results: 10, 20 or 40 | 20 |
| Display columns | Any of description, due date, assignee, location, complete date and labels | Description, due date, assignee, location |
| Sort by | Due date, assignee or title, with a Reverse sort box | Due date |
Good to know:
- There's no due-date filter and no "overdue only" option: sort by due date instead (finding overdue tasks).
- Every space has to be entered one by one; there's no "all spaces" option (CONFCLOUD-71390).
- The macro can't be added to a live doc yet. Add it to a page, or convert the live doc to a page.
- It has no wiki markup form, and the Task report template creates a page with the macro already on it.
For admins and developers
- REST API:
GET /wiki/api/v2/taskslists the tasks the caller can see. Useful filters:status=incomplete,assigned-to=<account id>,due-at-to=<time in milliseconds>,space-idandbody-format=storagefor the task text. Results come in pages: follow_links.nextuntil it's gone. - In the page's storage format, a task list is
<ac:task-list>holding one<ac:task>per task, each with an<ac:task-status>(incompleteorcomplete) and an<ac:task-body>.
Need it across all spaces?
The Task report only covers the spaces you list, and has no overdue filter or counts. All-Spaces Task Report shows every task from every space you can see in one report, overdue first, with counts by space or person, and can post a weekly digest that @mentions everyone with overdue tasks.
Disclosure: Kitefold makes All-Spaces Task Report, so we're not neutral. Everything above this box works with Confluence on its own.
Related guides
- How to see all tasks across Confluence spaces
- How to find overdue tasks in Confluence
- How to see all the Confluence tasks assigned to you
- How to send a weekly reminder for overdue Confluence tasks
Checked against Atlassian's Confluence Cloud documentation in November 2026. Confluence changes often; if something here no longer matches what you see, email support@kitefold.app and we'll update it.