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

# Tasks

> Create, track, and manage work items across your projects.

Tasks are the core unit of work in TaskFlow. Every task belongs to a project and is automatically assigned a unique ID — combining the project's short code with a sequence number (e.g., `ENG-123`).

## Task types

Choose a type when creating a task to communicate what kind of work it represents.

| Type        | Description                                               |
| ----------- | --------------------------------------------------------- |
| **Epic**    | A large body of work that spans multiple stories or tasks |
| **Story**   | A user-facing feature or requirement                      |
| **Task**    | A standard unit of work                                   |
| **Bug**     | A defect or unexpected behavior to be fixed               |
| **Subtask** | A smaller piece of work nested under a parent task        |

## Task fields

<AccordionGroup>
  <Accordion title="Title and description">
    Every task requires a title. Add a description to provide context, acceptance criteria, or relevant links. Descriptions support rich text formatting.
  </Accordion>

  <Accordion title="Status">
    Status tracks where a task is in your workflow.

    | Status          | Meaning                     |
    | --------------- | --------------------------- |
    | **Backlog**     | Not yet scheduled for work  |
    | **Todo**        | Planned and ready to start  |
    | **In progress** | Actively being worked on    |
    | **In review**   | Awaiting review or approval |
    | **Done**        | Work is complete            |
    | **Canceled**    | Will not be completed       |

    <Tip>Projects can set work-in-progress (WIP) limits per status column. When a column is full, you'll be notified before adding another task.</Tip>
  </Accordion>

  <Accordion title="Priority">
    Priority signals urgency so your team can focus on what matters most.

    | Priority   | When to use                             |
    | ---------- | --------------------------------------- |
    | **None**   | No priority assigned                    |
    | **Low**    | Nice to have, non-urgent                |
    | **Medium** | Should be addressed soon                |
    | **High**   | Important, plan to complete this sprint |
    | **Urgent** | Must be resolved immediately            |
  </Accordion>

  <Accordion title="Assignee and due date">
    Assign a task to any project member. Set a due date to surface the task in deadline views and priority dashboards. When you assign a task to someone else, they receive a notification automatically.
  </Accordion>

  <Accordion title="Story points and hours">
    * **Story points** — An abstract measure of effort used in sprint planning.
    * **Estimated hours** — The time you expect the task to take.
    * **Actual hours** — The time it actually took, recorded when the task is complete.
  </Accordion>

  <Accordion title="Tags">
    Tags are shared across your workspace and let you group related tasks across projects. You can filter and search by tag from any task list view.
  </Accordion>
</AccordionGroup>

## Subtasks

Break large tasks into smaller, manageable pieces by adding subtasks. A subtask is a full task with its own status, assignee, and due date, nested under a parent.

<Steps>
  <Step title="Open a task">
    Click any task to open its detail panel.
  </Step>

  <Step title="Add a subtask">
    Scroll to the **Subtasks** section and click **Add subtask**. Give it a title and it will appear nested beneath the parent.
  </Step>

  <Step title="Track progress">
    The parent task shows a progress indicator based on how many subtasks are done.
  </Step>
</Steps>

## Task dependencies

Link tasks to one another to make relationships explicit and prevent blockers from going unnoticed.

| Dependency type   | Meaning                                                 |
| ----------------- | ------------------------------------------------------- |
| **Blocks**        | This task must be done before the linked task can start |
| **Is blocked by** | This task cannot start until the linked task is done    |
| **Relates to**    | A general connection between two tasks                  |
| **Duplicates**    | This task covers the same work as the linked task       |

To add a dependency, open a task and navigate to the **Dependencies** section. Search for any task in the same project and select the relationship type.

## Watching tasks

Watch a task to receive notifications whenever it changes — including status updates, new comments, and reassignments.

Click the **Watch** button on any task to toggle watching on or off. You can watch tasks that aren't assigned to you to stay informed about progress.

## Attachments

Upload files directly to a task to keep relevant assets — screenshots, designs, documents — alongside the work. Supported file types include images, PDFs, and common document formats.

## Comments and @mentions

Use comments to discuss a task with your team without leaving TaskFlow.

<Note>
  Type `@` followed by a teammate's name to mention them in a comment. They will receive an in-app notification linking directly to the comment.
</Note>

## Activity log

Every change to a task is recorded in the **Activity** tab: status changes, reassignments, priority updates, and more. The activity log is a full, timestamped audit trail that you can use to understand how a task evolved over time.

## Kanban board

Each project has a Kanban board where tasks are displayed as cards grouped by status. The board updates in real time — when a teammate moves a card, you see it instantly without refreshing.

Drag and drop cards between columns to change their status. If a column has a WIP limit configured, you'll see the current count and the limit displayed on the column header.

<Warning>
  Adding a task to a column that has reached its WIP limit will trigger a warning. Respect WIP limits to prevent bottlenecks and keep work flowing smoothly.
</Warning>