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

# Create a task

> Add a task from the project list, the board, the task detail pane, or the Tasks page. Learn what each entry point fills in for you and what it leaves blank.

You can add a task from four places. All of them create the same kind of task – the difference is only how much they fill in for you.

## When to use each entry point

| Entry point          | Where                   | Fills in                      |
| -------------------- | ----------------------- | ----------------------------- |
| Section **+** button | Project → **List** tab  | Project, section              |
| Column **+** button  | Project → **Board** tab | Project, section              |
| Quick add bar        | **Tasks** page          | Start date, project, assignee |
| **Add subtask**      | Task row or task detail | Project, section, parent task |

## Add a task from the project list

<Steps>
  <Step title="Open the project">
    Go to **Projects** and pick the project. The **List** tab opens by default.
  </Step>

  <Step title="Find the section">
    Each section is its own card, with the section name, a count of its tasks and the time tracked against it.
  </Step>

  <Step title="Click the + button">
    The **+** sits in the section header, next to the three-dot menu. A small popover opens with a single input.
  </Step>

  <Step title="Type the title and press Enter">
    The task appears at the bottom of that section. Press **Escape** to close the popover without adding anything.
  </Step>
</Steps>

A task created this way starts with priority **Medium** and is marked **billable**.

## Add a task from the board

<Steps>
  <Step title="Open the Board tab">
    Go to the project and click **Board**.
  </Step>

  <Step title="Click + on a column">
    The **+** is in the column header. An inline form opens inside the column.
  </Step>

  <Step title="Type the title">
    Press **Enter** or click **Add**. Press **Escape** to cancel.
  </Step>
</Steps>

<Tip>
  An empty column shows a full-width **Add task** affordance instead of a small **+**, so a fresh board is never a dead end.
</Tip>

## Add a task from the Tasks page

The **Tasks** page has a quick add bar at the top. It is built for speed: type a title, press **Enter**, and the task is created.

<Steps>
  <Step title="Type the title">
    Click **Add a task** and type. Press **Escape** to clear the bar and reset every choice below it.
  </Step>

  <Step title="Set the day (optional)">
    The date chip below the input defaults to today. Click it to open the calendar, which offers **Today**, **Tomorrow**, **Next week** and **No date**.
  </Step>

  <Step title="Pick a project (optional)">
    Leave it blank and the task goes into your workspace's hidden container project. It still appears on your Tasks page.
  </Step>

  <Step title="Pick who it is for (optional)">
    Defaults to you. The list only offers people you are allowed to assign to.
  </Step>

  <Step title="Press Enter">
    The task is created. The title clears and the date resets to today. The project and the person stay, so adding three tasks for the same project takes three keystrokes.
  </Step>
</Steps>

<Note>
  The quick add bar sets a **start date**, not a due date. A new task is due the day it starts. If the work runs longer, push the due date out later from the task detail – see [/tasks/task-fields](/tasks/task-fields).
</Note>

## Add a subtask

Subtasks are one level deep. A subtask cannot have subtasks of its own.

<Steps>
  <Step title="Hover a task row">
    In the project **List** tab, a **+** appears at the right of the row. It only appears on top-level tasks.
  </Step>

  <Step title="Type the subtask title">
    Press **Enter**. The subtask lands in the same section as its parent.
  </Step>
</Steps>

You can also open a task and use the **Subtasks** section, which lets you set an assignee at the same time. See [/tasks/subtasks](/tasks/subtasks).

## What happens next

* The task is added at the **bottom** of its section, so nothing you already ordered moves.
* If you set an assignee other than yourself, that person is notified.
* If you set a due date, a reminder is scheduled ahead of the deadline.
* The task is given its permanent task number, for example `WR-142`. See [/tasks/task-numbers](/tasks/task-numbers).

## Example

Priya Raman is planning the next sprint on **Website Redesign** for Bluebird Coffee.

She opens the project, clicks **+** on the **To do** section and types "Homepage wireframes". The task appears at the bottom of To do with priority Medium.

She clicks the task to open the detail pane, sets the assignee to Sarah Lin, sets the due date to Friday, and sets the estimate to 6 hours. Sarah gets a notification that the task is hers.

## Options and settings

Task creation only asks for a title. Everything else is set afterwards from the task detail. The one rule the title must pass:

| Rule           | Value                             |
| -------------- | --------------------------------- |
| Minimum length | 1 character after trimming spaces |
| Maximum length | 500 characters                    |

A blank or spaces-only title is rejected.

## Permissions

Creating a task needs the `task.create` capability.

| Role            | Can create a task |
| --------------- | ----------------- |
| Owner           | Yes               |
| Admin           | Yes               |
| Project Manager | Yes               |
| Finance         | No                |
| Member          | Yes               |
| Contractor      | Yes               |
| Client          | No                |

If you cannot see the **+** buttons, you do not hold `task.create`. The server checks again on save, so the buttons being hidden is convenience, not the boundary.

The **Projects & tasks** app must also be switched on. See [/concepts/apps-and-modules](/concepts/apps-and-modules).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Nothing happens when I press Enter">
    The title is blank or is only spaces. Type at least one visible character.
  </Accordion>

  <Accordion title="I get a message about permission">
    Your role does not hold `task.create` in this workspace. Ask an Owner or Admin, or check [/tasks/task-permissions](/tasks/task-permissions).
  </Accordion>

  <Accordion title="The project has no sections">
    A project with no sections shows "No sections yet" and an **Add section** button. Add a section first – a task has to live in one.
  </Accordion>

  <Accordion title="The + for subtasks is missing on a row">
    That row is already a subtask. Subtasks cannot be nested.
  </Accordion>

  <Accordion title="My new task is not on the Tasks page">
    The Tasks page shows work assigned to you, within a rolling window of today plus seven days, plus undated work and a capped peek at anything further out. If the task is assigned to someone else or due far in the future, it may sit outside that window. Use the search box.
  </Accordion>
</AccordionGroup>

## Related guides

<CardGroup cols={2}>
  <Card title="Task fields" icon="list" href="/tasks/task-fields">
    Every field a task carries.
  </Card>

  <Card title="Task details" icon="panel-right" href="/tasks/task-details">
    The detail pane and the full task page.
  </Card>

  <Card title="Subtasks" icon="list-tree" href="/tasks/subtasks">
    Break a task into steps.
  </Card>

  <Card title="My tasks" icon="user" href="/tasks/my-tasks">
    The quick add bar and day buckets.
  </Card>

  <Card title="Project sections" icon="columns" href="/projects/project-sections">
    Sections are where tasks live.
  </Card>
</CardGroup>