---
title: "Create a task"
canonical: "https://support.appfire.com/space/CDML/649759190/Create%20a%20task"
format: markdown
---
> Macro (aura-html)


## Overview

In **taskable** workflow states, you can add your own workflow tasks using the [Tasks dialog box](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649824290).

## Open the Tasks dialog box

Click the **Tasks **link in the [workflow status bar](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650117676) to open the [tasks dialog box](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649824290):

![tasksdialogbox_no_tasks.png](media://9f1805ea-b430-418e-a582-76a42b44743a)

> 📝 If the **Tasks** byline link is not visible, you can open the** tasks dialog box** using the [Page Tools Menu](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649856105) > [Add Task](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649890180)** **(this is when the workflow state is configured as **taskable**, which then allows the addition of workflow tasks when in that workflow state).

Click the **New Task** text and enter the name of the task.

### Name the task

Type in the task name – this should be a concise statement about what needs to be done.

![image](media://d1e83edb-a863-4fdb-a7fc-e6722c820e44)

### Assign the task

You can **@mention** one user, just like you can in a Confluence task; the user is added as the task assignee.

![tasksdialog_addingtask_withassignee.png](media://bc412d08-3bdc-4460-918f-647931f9c65c)

### Task description

If you want to add additional information

- Press **Shift + Enter** to start a new line, and then you can add a description

![tasksdialog_addingtask_withassignee_add_description.png](media://e1349ae8-1ed0-4f63-a26b-b01a32e4c060)

### Adding the task

Pressing **Enter** adds the task.

![tasksdialog_added_one_task_withassignee_withdescription.png](media://71a98b3e-eac8-4e1f-a9d2-f511c5baea00)

The number of pending tasks is added to the tasks byline. If the current user is assigned a task, a blue dot is appended to the byline and to the assigned task in the tasks dialog box.

Mouse over a task to display options to [edit](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649563090) the task details, including [task expiration](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649661544), [task assignment](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649792357), or [deletion](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649661693).

![tasksdialog_extract_task_with_options.png](media://5d1593b3-d87f-4262-81e0-3d0edb542042)

The checkbox is used to set the task as [complete](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650119401). Only one user needs to mark a task as complete. By default, assigning a task does not exclude any other user from completing the task.

## Notifications and reporting

Depending on the App configuration (see below), a user assigned to the task, or watching the page, receives notifications to let them know of the changes.

Details of the changes are stored in the [Activity Report - Content](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650119122).

## See also

[Reporting Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649070833):

- [Report on tasks](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649661358)

[Workflow Authoring Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/648611901):

- [Notifications](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649957056)
- [Tasks](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649694408)

[Administration Guides](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649233819):

- [Configuration - space tools](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649956239)
- [Notifications - space tools](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650119000)

| [‹ Back to Tasks dialog box](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649824290) |
| --- |