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

# Type a task in one line

> Write the date, time, duration, priority, labels, project and reminders into a task's title, and Heym fills them in. A cheat sheet with every pattern.

When you type a task's title, Heym spots dates, times, durations, priorities, labels, a home and reminders in it. Each one turns into a highlighted part of the title and becomes a detail of the task, so "Call the movers Friday 3pm-4pm p2" is a one-hour call on Friday at 3:00 PM with medium priority.

This works wherever you type a task's title: the **New task** window (press **C**), **New task** at the end of a list, and when you rename a task.

<video autoPlay muted loop playsInline src="https://mintcdn.com/heym/RxdohfEkT1hOgZzU/videos/quick-entry/type-a-task.mp4?fit=max&auto=format&n=RxdohfEkT1hOgZzU&q=85&s=aac388d1b52ac8c07b26f981d171a225" aria-label="In the New task window, typing Call the movers Friday 3pm-4pm p2, then +lis and picking the project Move to Lisbon, then !30m. Friday 3pm-4pm, p2, Move to Lisbon and !30m are highlighted as they're recognized" />

Typing a task with its date, time, priority, project and reminder

## How it works

1. Type the title and the details in any order.
2. Watch for the highlight: each part Heym picks up gets a light orange background. A highlighted part becomes a detail of the task and is left out of the saved title. The example above saves as "Call the movers".
3. After **#**, **+**, **!** or **@**, a list opens. Pick an entry with the arrow keys and **Enter**, or click it.
4. Press **Enter** or click **Create** to save the task.

To check or change a detail afterwards, open the task. Everything Heym picked up is there, under **Date**, **Priority**, **Labels**, **Alignment** and **Reminders**.

## Cheat sheet

### Dates and times

| Type | What Heym sets |
| - | - |
| `today`, `tomorrow` | That day |
| `friday` | The coming Friday, or today if it's Friday |
| `next friday` | Friday of next week. Typed on a Wednesday, that's the Friday 9 days later, not the one in 2 days. |
| `next week` | 7 days from today |
| `in 3 days`, `in 2 weeks` | That many days or weeks from today |
| `Oct 10th`, `21 jan`, `10/12` | That date. Month first: `10/12` is October 12. A date that has passed this year means next year. |
| `this weekend`, `end of month` | This Saturday, or the last day of this month |
| `3pm`, `14:00` | Today at that time, or tomorrow if that time has already passed |
| `tomorrow 3pm`, `today at 5pm` | That day and time |
| `in 30 minutes` | Today, starting 30 minutes from now |
| `3pm-5pm`, `3-5pm` | Start time 3:00 PM and a duration of 2 hours |

Write times with am or pm, or as 24-hour time. `at 3` alone means 3:00 in the morning. `noon` only counts next to a day, such as `today noon` or `noon tomorrow`; on its own it stays plain text.

Typed `next week` is 7 days from today. The **Next week** button in the date picker picks the first day of next week instead (see [Tasks](/help/tasks.md#date-start-time-and-duration)).

### Duration

| Type | What Heym sets |
| - | - |
| `30m`, `2h` | 30 minutes, 2 hours |
| `45 min`, `30 minutes`, `1 hour`, `2 hrs` | The same, with the unit written out. Write the number in digits: `10 minutes`, not `ten minutes`. |

A duration can go anywhere in the title, also next to a time: `9am 1h` starts at 9:00 AM and lasts an hour. Durations go up to 24 hours; a longer one such as `72h` isn't picked up.

### Priority

| Type | Priority |
| - | - |
| `p1` or `!!1` | **High** |
| `p2` or `!!2` | **Medium** |
| `p3` or `!!3` | **Low** |
| `p4` or `!!4` | **None** |

If you type more than one, the last one counts and the others stay in the title.

### Labels, home, reminders and people

| Type | What happens |
| - | - |
| `#` and a name | Adds that label. Type a few letters and pick it from the list, or choose **Create** with the name to make a new label. Add as many labels as you like. |
| `+` and a name | Files the task in a project, goal or life area. The list shows matches under **Projects**, **Goals** and **Life areas**. A task has one home, so a second `+` replaces the first. |
| `!` and a time | Adds a reminder: `!30m` for 30 minutes before the start, `!2h`, `!1d` or `!1w` for hours, days or weeks before, `!2pm` or `!14:00` for that time on the task's day, `!start` for when it starts. |
| `@` and a name | Assigns the task to someone, when it's in a project, goal or life area you share with them. |

![The New task window with Call the movers +lis typed, and a list under it showing Move to Lisbon under Projects and Move to Lisbon under Goals](https://mintcdn.com/heym/n5OvCilbUvjGlsuj/images/quick-entry/plus-menu.webp?fit=max\&auto=format\&n=n5OvCilbUvjGlsuj\&q=85\&s=3e184e3cea3fde7d8b206cf64edbeb07)

Typing + shows your projects and goals

![The New task window with Pick up the dry cleaning #errands typed, and a list offering Create errands](https://mintcdn.com/heym/n5OvCilbUvjGlsuj/images/quick-entry/label-create.webp?fit=max\&auto=format\&n=n5OvCilbUvjGlsuj\&q=85\&s=2075788ec2854f4b9ac4dd574e28b079)

A label that doesn't exist yet

A reminder that counts back from the start needs a start time, so add one with the date (`tomorrow 3pm !30m`). How reminders reach you, and what you can type after `!`, is on [Reminders](/help/reminders.md).

## Keep a word as plain text

Sometimes a word that's part of the title gets picked up, such as "Tomorrow" in "Read Tomorrow and Tomorrow".

* **Keep the word, drop the detail:** put the cursor right after the highlighted part and press **Backspace** once. The highlight goes away, the word stays in the title, and Heym leaves it alone from then on.
* **Drop both:** click the highlighted part. The word and its detail are removed together.

## Words Heym leaves alone

To avoid false matches in ordinary titles, Heym doesn't read these as dates:

* Short day names on their own: `mon`, `tue`, `wed`, `thu`, `fri`, `sat`, `sun`. Write the full day, such as `friday`, or add a time: `fri 3pm` works.
* `may` and `march` on their own, even after "in". With a day they count: `may 5`, `march 3`.
* Other month names on their own, such as "archive the april docs". After "in" they count: `in april` sets April 1.
* Plain numbers, such as "Buy a 2024 calendar".
* Words like "week" or "day" in a sentence, such as "Plan the week".

> [!NOTE]
>
> Typing a schedule like "every monday" doesn't make the task repeat: Heym reads "monday" as the coming Monday and keeps "every" in the title. Set the schedule with **Repeat** in the date picker instead. See [Repeating tasks](/help/repeating-tasks.md).

## Typing in German

With **Language** set to **Deutsch** in **Settings** → **Preferences**, Heym reads German dates and times too: `morgen`, `nächsten Freitag`, `morgen 15 Uhr`. English ones such as `tomorrow` still work. Durations work in either language, whichever you've chosen: `2 Std`, `30 Minuten`, `2h`.

In German, a short word followed by a number can read as a weekday and time: "Do 20 pushups" becomes Thursday at 20:00. Press **Backspace** right after the highlight to keep the words as text.

## Related

> [card] [Tasks](/help/tasks.md)
>
> Every detail a task can have, and how to change it later.

> [card] [Reminders](/help/reminders.md)
>
> What to type after ! and when reminders arrive.

> [card] [Labels](/help/labels.md)
>
> Rename, recolor and browse your labels.

> [card] [Inbox, Today and Upcoming](/help/inbox-today-upcoming.md)
>
> Where your new task shows up.


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