> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aseeflow.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Add a User Task to the Process

This guide teaches you how to involve humans in your BPMN 2.0 process by adding user tasks.

## Add a user task

Open your process in the Camunda Modeler and follow these steps:

1. Use the create/remove space tool to add space between the start event and the *Charge Credit Card* service task.
2. Select the activity shape (rounded rectangle) and drag it between these elements.
3. Name the new activity *Approve Payment*.
4. Change its type to *User Task* using the wrench button.

<img src="https://mintcdn.com/aseeflow/nrz9o5m15i2WLCpp/get-started/quick-start/img/modeler-usertask1.png?fit=max&auto=format&n=nrz9o5m15i2WLCpp&q=85&s=8611f6691c241a3bdc5d85e369260299" alt="Add an activity between the start event and the service task" width="1200" height="673" data-path="get-started/quick-start/img/modeler-usertask1.png" />

<img src="https://mintcdn.com/aseeflow/nrz9o5m15i2WLCpp/get-started/quick-start/img/modeler-usertask2.png?fit=max&auto=format&n=nrz9o5m15i2WLCpp&q=85&s=4a8b6b6d62a7d01a8c37069479a270a9" alt="Change the activity type to user task" width="1200" height="673" data-path="get-started/quick-start/img/modeler-usertask2.png" />

## Configure the user task

In the properties panel on the right:

1. Select your user task.
2. Scroll to the `Assignee` property.
3. Enter *demo* to automatically assign the task to the demo user.

<img src="https://mintcdn.com/aseeflow/nrz9o5m15i2WLCpp/get-started/quick-start/img/modeler-usertask3.png?fit=max&auto=format&n=nrz9o5m15i2WLCpp&q=85&s=d439514adc0e7c5a0736b495f7361728" alt="Set the assignee" width="420" height="452" data-path="get-started/quick-start/img/modeler-usertask3.png" />

## Configure a basic form

Still in the properties panel:

1. Select the user task.
2. Click the *Forms* tab.
3. Set the following properties:
   * **Type:** Camunda Forms
   * **Form Ref:** payment-form
   * **Binding:** deployment

Create a new form file by selecting **File > New File > Form** and set the `Id` to `payment-form`.

<img src="https://mintcdn.com/aseeflow/nrz9o5m15i2WLCpp/get-started/quick-start/img/modeler-usertask-add.png?fit=max&auto=format&n=nrz9o5m15i2WLCpp&q=85&s=277e33762d23bd0d78966ad5b3c930cd" alt="Reference the form from the user task" width="1200" height="673" data-path="get-started/quick-start/img/modeler-usertask-add.png" />

<img src="https://mintcdn.com/aseeflow/nrz9o5m15i2WLCpp/get-started/quick-start/img/modeler-usertask-form.png?fit=max&auto=format&n=nrz9o5m15i2WLCpp&q=85&s=2964e37b9a2960233c9bb7f4d6ebfcc6" alt="Create a new form" width="1073" height="684" data-path="get-started/quick-start/img/modeler-usertask-form.png" />

### Add form fields

Drag elements from the form elements library to create three fields:

**Field 1 (Number)** — Key: `amount`, Label: *Amount*

<img src="https://mintcdn.com/aseeflow/nrz9o5m15i2WLCpp/get-started/quick-start/img/modeler-usertask4.png?fit=max&auto=format&n=nrz9o5m15i2WLCpp&q=85&s=882ce10645cd0e30882f8aac5190ecde" alt="Add the amount field" width="2400" height="1752" data-path="get-started/quick-start/img/modeler-usertask4.png" />

**Field 2 (Text Field)** — Key: `item`, Label: *Item*

<img src="https://mintcdn.com/aseeflow/nrz9o5m15i2WLCpp/get-started/quick-start/img/modeler-usertask5.png?fit=max&auto=format&n=nrz9o5m15i2WLCpp&q=85&s=e0b740568994ddf75d6a6542b861a05c" alt="Add the item field" width="2400" height="1752" data-path="get-started/quick-start/img/modeler-usertask5.png" />

**Field 3 (Checkbox)** — Key: `approved`, Label: *Approved?*

<img src="https://mintcdn.com/aseeflow/nrz9o5m15i2WLCpp/get-started/quick-start/img/modeler-usertask6.png?fit=max&auto=format&n=nrz9o5m15i2WLCpp&q=85&s=60da70e1fe384869b4b4784b2ec6839f" alt="Add the approved field" width="2400" height="1752" data-path="get-started/quick-start/img/modeler-usertask6.png" />

Select **Camunda Platform** as your execution platform in the lower-left corner and click *Apply*.

<img src="https://mintcdn.com/aseeflow/nrz9o5m15i2WLCpp/get-started/quick-start/img/modeler-platform-selection.png?fit=max&auto=format&n=nrz9o5m15i2WLCpp&q=85&s=a7a7163801727693b1958601d7f19473" alt="Select the execution platform" width="802" height="456" data-path="get-started/quick-start/img/modeler-platform-selection.png" />

Save the form as `payment.form`.

## Deploy the process

1. Switch back to the process diagram.
2. Click the deploy button.
3. In the deployment panel, select `payment.form` under *include additional files*.
4. Click *Deploy*.

<img src="https://mintcdn.com/aseeflow/nrz9o5m15i2WLCpp/get-started/quick-start/img/modeler-deploy-form.png?fit=max&auto=format&n=nrz9o5m15i2WLCpp&q=85&s=7151c8a0bec3e8402b15e8526cfb32fc" alt="Include the form file in the deployment" width="2400" height="1752" data-path="get-started/quick-start/img/modeler-deploy-form.png" />

## Work on the task

Navigate to Tasklist at [http://localhost:8080/camunda/app/tasklist/](http://localhost:8080/camunda/app/tasklist/) and log in with the credentials `demo` / `demo`.

1. Click *Start process*.
2. Select *Payment Retrieval* from the list.
3. Use the generic form to set process variables.
4. Click *Add a variable* to create rows.
5. Click *Start*.

<img src="https://mintcdn.com/aseeflow/nrz9o5m15i2WLCpp/get-started/quick-start/img/start-form-generic.png?fit=max&auto=format&n=nrz9o5m15i2WLCpp&q=85&s=7c8023037e218522393aad0facaaf783" alt="Start a process instance with the generic form" width="2800" height="1402" data-path="get-started/quick-start/img/start-form-generic.png" />

You should see the *Approve Payment* task in your Tasklist. Select it and view the *Diagram* tab to see the highlighted user task.

<img src="https://mintcdn.com/aseeflow/nrz9o5m15i2WLCpp/get-started/quick-start/img/diagram.png?fit=max&auto=format&n=nrz9o5m15i2WLCpp&q=85&s=a22961dc310df52f0115f487d0a2d7b2" alt="The highlighted user task in the diagram" width="1400" height="700" data-path="get-started/quick-start/img/diagram.png" />

Click the *Form* tab to work on the task using the auto-generated form fields.

<img src="https://mintcdn.com/aseeflow/nrz9o5m15i2WLCpp/get-started/quick-start/img/task-form-generated.png?fit=max&auto=format&n=nrz9o5m15i2WLCpp&q=85&s=c10e2fbfbd960ae139370f4bcc73cbc2" alt="The generated task form" width="2800" height="1402" data-path="get-started/quick-start/img/task-form-generated.png" />

<Tip>
  If you don't see any tasks in your Tasklist, you might need a filter. Add one by clicking *Add a simple filter* on the left.
</Tip>

## Next step

Learn how to make your process more dynamic by [adding gateways](/get-started/quick-start/gateway).

<Note>
  **Catch up: get the sources of Step-3**

  ```bash theme={null}
  git clone https://github.com/aseeflow/aseeflow-get-started-quickstart.git
  git checkout -f Step-3
  ```

  Or [download as a `.zip`](https://github.com/aseeflow/aseeflow-get-started-quickstart/archive/Step-3.zip).
</Note>
