Managing Tasks in Confluence

You can manage your personal tasks in the notification-and-task dialog, known as the Confluence 'workbox', which drops down when you choose the icon in the Confluence page header.

You can also create a list of tasks on a page, and assign them to your colleagues via @mention. Changes made in the workbox are reflected in the task list on the page, and changes made on the page are reflected in the workbox too.

Creating personal tasks and having tasks assigned to you

There are a few ways that you and other people can assign tasks to you:

You can add a personal task via the workbox.
You can add a notification to your task list, via the notification workbox. This is useful if you want to get back to it later.
Someone can assign you a task from a task list on a Confluence page.
Other Confluence actions may create a task for you. For example, your Confluence site may be running a plugin that creates and assigns tasks.

On this page:

Related pages:

Managing your personal tasks in the workbox

The workbox displays your notifications and your personal tasks in separate tabs. The task tab shows the tasks assigned to you. When you update a task that originated in a task list on a page, the update is reflected in the task list too.

Screenshot: Your personal tasks in the workbox

To manage your tasks:

Choose the workbox icon in the Confluence page header.
- You can use the keyboard shortcut: Type g then n. (When in the Confluence editor, click outside the editor pane before pressing the keyboard shortcut keys.)
- The icon indicates the number of unread notifications.
Choose the personal tasks icon:
To add a task and assign it to yourself, type the task summary in the text box and choose Add task.
To prioritise tasks, drag and drop them into your chosen order. (Click a task, hold down your mouse button to drag the task into position, then release the mouse button.)
To complete a task, or mark it as incomplete, choose the check box next to the task.
To add notes to a task and see further information (for example, a related page) choose the task item. The task details dialog will open.
To see the tasks that are marked as complete, choose View completed.

Adding your notifications to your task list

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

Creating task lists and managing tasks on a page

Task lists on a page are useful for assigning and managing tasks in a team.

To add a task list on a page:

Edit the page.
Choose the task-list icon in the editor toolbar, or press [ and then ] on your keyboard.
Type the description of the task.
If you want to assign a task to someone, type '@' and the person's name in the task description. (For more information about @mentions, see Using Mentions.) That person will receive a notification, and the task will appear in their personal task list in the workbox. If you @mention yourself, the task will appear in your personal task list.
To end the list, press Enter twice.

Keyboard shortcuts:

To add a task list, press press [ and then ] on your keyboard.
To indent a task, press Tab.
To undo an indent, press Shift+Tab.

Managing tasks on a page:

When viewing a page, you and other viewers can mark tasks as complete or incomplete. Updates to a task on the page will be transferred to the workbox too. (See above.)
To be able to update a task list when in view mode, you need permission to edit the page:
- You need the 'Create page' permission in the space. See Space Permissions Overview.
- There must not be any page restrictions that prevent you from editing the page. See Page Restrictions.

What if the update fails?

Error rendering macro 'excerpt-include'

No link could be created for 'DOC:Failed Update to Task List'.

Screenshot: A task list on a page

Managing tasks with Confluence mobile

You can view and manage your tasks on your phone or other mobile device too. See Using Confluence on a Mobile Device for more about mobile platforms.

MobileTasks

Notes

Administrators can enable and disable the workbox on your Confluence site. They can also connect a Jira site or another Confluence site, so that notifications from those sites appear in your workbox too. See Configuring Workbox Notifications.
The Confluence workbox is provided by a set of plugins. To remove the personal notifications and tasks functionality from your site, you can disable the following plugins. See Disabling or Enabling a Plugin for instructions. Disabling these plugins will disable the entire workbox . It is not possible to disable only tasks or only notifications:
- Workbox - Common Plugin
- Workbox - Host Plugin
- Workbox - Confluence Provider Plugin
If you want to re-enable the plugins, do so in the following order: Common Plugin, Host Plugin, Confluence Provider Plugin.
There is no option to disable the workbox for an individual user.

Completed tasks in the workbox are automatically deleted after 7 days.
You cannot disable the functionality that provides task lists on a page.
There is no link between the tasks in a Tasklist Macro and the tasks described above. The tasks from the macro do not appear in the workbox.

Page tree