# Add Tasks

This how-to covers adding new tasks to your list. For subtasks, scheduling, repeating tasks, and issue-linked tasks, see [[2.04-Manage-Subtasks]], [[2.05-Manage-Scheduled-Tasks]], [[2.06-Manage-Repeating-Tasks]], and [[2.07-Manage-Task-Integrations]].

## Open the Add Task bar

**From the header:** Click the **Add new task** button (plus icon) in the top bar. The add task bar opens and the cursor focuses in the input.

**With the keyboard:** Press **Shift+A** (default shortcut for "Add new task"). You can change or confirm the key under [[3.02-Settings-and-Preferences]] → Keyboard; see [[3.03-Keyboard-Shortcuts]].

## Create a Task

1. With the add task bar open, type the task title in the input. The placeholder shows an example: **A task title #tag @16:00 t25m** (you can use **#tag**, **@time**, **@date**, and **[t]time** in the title; see below).
2. Press **Enter** or click the **Add task** button (plus icon next to the input). The task is added to the current project or context (Today / tag).

The new task appears at the **top** or **bottom** of the list depending on the add bar setting (see “Add to top or bottom” below).

## Short Syntax in the Title

While typing the title you can use:

- **#tagName** — Add the task to a tag (e.g. `#work`). If the tag does not exist, you can create it when adding the task.
- **@16:00** or **@09:30** — Set a due time for the task (today by default when only time is given).
- **@tomorrow**, **@next week**, or a date — Set the due date. You can combine with a time (e.g. **@tomorrow @14:00**).
- **[t]25m** — Set an estimated time for the task. You can also add time previously spent on a task by adding a `/` at the end (e.g. `t30m/`). The `t` tag is optional and the short syntax will work even if it is ommitted.

See [[3.04-Short-Syntax]] for more information on available short syntax tags.

The add task bar also has **Tags**, **Schedule**, and **Estimate** buttons to set these without typing. On the Schedule/Planner view, the add bar may show different options (e.g. “Plan for today”).

## Add to top or Bottom

Next to the input there is a button that toggles whether new tasks go to the **top** or **bottom** of the list. The tooltip shows “Add to top (Ctrl+1)” or “Add to bottom (Ctrl+1)”. You can also press **Ctrl+1** (or the key you configured) to toggle. This applies to the next task you add.

## Add to Backlog or Today (if the Project Has a backlog)

If the current project has **Backlog** enabled, another button appears: **Add to backlog** / **Add to today**. It toggles whether the new task is added to the project’s **backlog** or to **today’s list**. The icon and tooltip (“Add to backlog” vs “Add to today”) show the current mode.

## Add Existing Tasks or Issues (search mode)

Click the **search** icon (or press **Ctrl+2**, if configured) in the add task bar to switch to **issue search** mode. The placeholder changes to “Add existing task or issues…”. You can search for:

- Tasks from the **archive** or other projects — select one to add it to the current context.
- **Issues** from configured integrations (Jira, GitHub, etc.) — select one to add it as a linked task.

Type to search, then choose an item from the list to add it. Disable search again with the search button or **Ctrl+2** to return to normal “create new task” mode.

## Where New Tasks Go

- **Project view:** Tasks are added to the **current project**. With “Add to backlog” on, they go to the project backlog; otherwise they go to the main list (or today, depending on context).
- **Today / tag view:** Tasks are added to the **current tag** (e.g. Today). They also belong to a project; if you are in a project’s Today view, the task is in that project.
- **Schedule / Planner:** When you use the add bar there, you can plan the task for a specific day (e.g. today); the task is scheduled for that day.

## Add a Task from the Schedule / Planner

On the Schedule or daily planning view, you may see an **Add** button (plus icon and “Add” label) for a day. Click it to open the same add task bar in place; the task can be created and planned for that day. Creating the task closes the inline add bar.
