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

# Creating a Task

> Create one task from the web form, choose who does it and set its time window.

> [!NOTE]
>
> Required permission:
>
> * View task
> * Create task
> * Assign task (to pick an assignee while creating)

A task can be created in several ways: from the web form described here, [in bulk](https://docsy3.mile.app/pages/activities/task/bulk-create.md) from a spreadsheet or a manual table, from the field app, by an [automation](https://docsy3.mile.app/pages/workflow/automation/introduction.md), by a [task schedule](https://docsy3.mile.app/pages/planning/schedule/task-schedule.md), or through the API.

## Create one task

1. Open **Activities › Task** and click **New**.
2. Pick the flow the task belongs to. The flow decides which fields the task carries, so it is chosen first.

![Pick a flow](https://mintcdn.com/mile-app/UXNIt6vKEPCdUxjB/images/v4/activities/task-new.png?fit=max\&auto=format\&n=UXNIt6vKEPCdUxjB\&q=85\&s=de824a701b20508ff9b5f36e063da74a)

3. Fill in the form. It shows the fields of the flow's initial page, the page that is filled in from the web.

![New task form](https://mintcdn.com/mile-app/UXNIt6vKEPCdUxjB/images/v4/activities/task-new-form.png?fit=max\&auto=format\&n=UXNIt6vKEPCdUxjB\&q=85\&s=931e78f311a516917a0eb3bc3663cf44)

1. **Flow**: the flow you picked. Change it to switch to another form.
2. **Fields**: the fields of the initial page. They differ per flow: text, numbers, dates, addresses, coordinates, choices, lists, bills and more. See [Components](https://docsy3.mile.app/pages/workflow/flow/components/introduction.md).
3. **Assignee**: pick one or more people to give the task to right away. Leave it empty to create the task as **Unassigned** and assign it later.
4. **Starts / Ends**: the time window of the task. They are filled in from the flow's [time configuration](https://docsy3.mile.app/pages/workflow/flow/configuration.md); change them for this task if you need to.
5. **Create task**: create the task.

The new task appears at the top of the list. It is **Unassigned**, or **Ongoing** when you picked an assignee.

> [!TIP]
>
> For an address field you can type the address and leave the coordinates empty: the coordinates are found from the address for you. If they cannot be found, a message asks you to check the address.

### What you see while filling in

* A field the flow marks as required shows "This flow requires an answer here." until it is filled in.
* **Starts** must be earlier than **Ends**.
* A field fed by a data source shows **Click here to choose the data for this task**: pick a row from the data source and its values fill the form.
* If the flow's initial page is turned off, the form says so and the task is created with only its time window and assignee.
* Fields the web form cannot fill in are listed under "Left for the field app to answer"; the field worker fills them in on the field app.
* If you close the form after changing something, **Discard changes?** asks before your input is lost.

When your plan's monthly task limit is reached, the form says so and links to **Billing plan**.

## Create tasks on the field app

Field workers can also create a task on the go, which is handy when the work is not planned in advance:

1. In the field app, tap **+** in the middle of the bottom menu.
2. Pick the flow.
3. Fill in the first page.
4. Tap **Create Task**.

## Related

* [Creating Tasks in Bulk](https://docsy3.mile.app/pages/activities/task/bulk-create.md)
* [Assigning Tasks](https://docsy3.mile.app/pages/activities/task/assign-task.md)
* [Subpage in a Task](https://docsy3.mile.app/pages/activities/task/subpage-in-task.md)
* [Subflow in a Task](https://docsy3.mile.app/pages/activities/task/subflow-in-task.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.