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

# Focus with the Pomodoro timer

> Work in focus blocks with short and long breaks, link the task you're working on, keep the timer in the sidebar, and set up profiles.

The Pomodoro timer splits your work into focus blocks with breaks in between: 25 minutes of focus, then a 5-minute break, and a longer break after every fourth block. You can tie the timer to the task you're working on and keep it running in the sidebar while you use the rest of Heym. This page covers starting it, the controls, profiles with your own lengths, and a one-off countdown.

> [!NOTE]
>
> The Pomodoro timer is part of Heym Pro. [Compare plans](/help/plans.md).

## Start the timer

Open the timer in one of these ways:

* **From a task**: open the task, click **⋯** at the top right of it, then **Start Pomodoro**. The task is linked to the timer.
* **From Home**: click **Start focus** at the top of Home, to the right of the **Add task...** box and **New note**. If you don't see it, click **⋯** at the top right of Home, point at **Configure widgets** and click **Quick actions** ([Customize Heym](/help/customize.md#choose-the-widgets-home-shows)).
* **With the keyboard**: press **G** then **F**, or press **⌘K**, type `Pomodoro` and pick it. The timer opens over Home, so you're on Home when you close it.

![The top of an open task, Draft the Q4 offsite agenda, with its ⋯ menu showing Start Pomodoro and Delete](https://mintcdn.com/heym/n5OvCilbUvjGlsuj/images/pomodoro/task-menu.webp?fit=max\&auto=format\&n=n5OvCilbUvjGlsuj\&q=85\&s=17eadf5c7ecbc1d17ec0949e068d5bc0)

Start Pomodoro in a task's ⋯ menu

The timer fills the window. Click the play button under the clock to start focusing.

![The Pomodoro timer: Add a task at the top, a ring with Focus, 25:00 and the Work profile inside, and a play button below](https://mintcdn.com/heym/n5OvCilbUvjGlsuj/images/pomodoro/timer.webp?fit=max\&auto=format\&n=n5OvCilbUvjGlsuj\&q=85\&s=26b433b37521c6fd15108a70f5947afc)

The timer, ready to start

## How a round works

With the standard **Work** profile:

1. **Focus** runs for 25 minutes.
2. A **Short break** of 5 minutes follows.
3. Focus and short breaks take turns until you've finished 4 focus blocks.
4. A **Long break** of 15 minutes follows. After it, the round is over and the timer is ready for the next one.

When a block ends, Heym plays a sound (unless you turned **Sound** off) and shows a notification, such as "Focus session complete! Time for a break." In a browser, the first start asks whether Heym may show notifications; allow it to get them. Notifications only appear while Heym is open.

The next block doesn't start on its own: after a focus block, the break waits until you click play. To have breaks or focus blocks start by themselves, turn on **Auto-start break** or **Auto-start focus** in the [profile](#set-up-profiles).

## Pause, skip or stop

While a focus block or break runs, three buttons sit under the clock:

| Button | What it does |
| - | - |
| Square (**End session**) | Stops the timer and resets it to the start of a round. The linked task is unlinked |
| Pause (**Pause**), then play (**Resume**) | Pauses the clock and starts it again where it stopped |
| Skip (**Skip to next phase**) | Ends the current block early and starts the next one, for example a break |

![The timer running at 24:57 with the linked task, Draft the Q4 offsite agenda, at the top, and the stop, pause and skip buttons under the clock](https://mintcdn.com/heym/n5OvCilbUvjGlsuj/images/pomodoro/running-with-task.webp?fit=max\&auto=format\&n=n5OvCilbUvjGlsuj\&q=85\&s=cac5e1166c97c9f403f2fb64afcb6379)

A running focus block with a linked task

## Link a task

Linking a task keeps it in front of you while you focus.

1. Click **Add a task** at the top of the timer.
2. Pick a task, or type to search. The list starts with today's and overdue tasks.

The task's title replaces **Add a task**, and the task opens on the right, so you can read it, edit it or complete it without leaving the timer. To unlink it, click the title and choose **Clear**. Starting the timer from a task's **⋯** menu links that task right away.

## Keep working while it runs

Click **×** at the top right of the timer, or press **Esc**, to go back to Heym. The timer keeps running, and a card at the bottom of the sidebar shows the block, the time left and the profile. Use its buttons to pause, resume or stop, or click the card to open the timer again.

![A card at the bottom of the sidebar, above Trash, showing Focus, 24:58 and the Work profile, with pause and stop buttons](https://mintcdn.com/heym/n5OvCilbUvjGlsuj/images/pomodoro/sidebar-widget.webp?fit=max\&auto=format\&n=n5OvCilbUvjGlsuj\&q=85\&s=a0c0ebcf38bf031a9b38f7717b357046)

The running timer in the sidebar

After you've opened the timer once since loading Heym, **⇧P** hides it and shows it again.

## Set up profiles

A profile holds your lengths and settings, so you can keep one for deep work and one for short tasks. To change a profile or add one:

1. With the timer stopped, click the profile name under the clock (it starts as **Work**).
2. Point at a profile and click **⋯** to change it, or click **New profile**.

![The profile list with Work at 25m and New profile, and next to it the Work settings: Focus 25 min, Short break 5 min, Long break 15 min, Sessions 4, Auto-start focus off, Auto-start break off and Sound on](https://mintcdn.com/heym/n5OvCilbUvjGlsuj/images/pomodoro/profile-settings.webp?fit=max\&auto=format\&n=n5OvCilbUvjGlsuj\&q=85\&s=71d701f9f434f8fc0f3604b506564588)

The settings of the Work profile

| Setting | What it does |
| - | - |
| Icon and name | Click the icon to pick another icon and color. The color is also the color of the ring |
| **Focus** | Length of a focus block, in minutes (standard: 25) |
| **Short break** | Length of a short break, in minutes (standard: 5) |
| **Long break** | Length of the long break, in minutes (standard: 15) |
| **Sessions** | Focus sessions before a long break (standard: 4) |
| **Auto-start focus** | Starts the next focus block by itself after a break |
| **Auto-start break** | Starts the break by itself after a focus block |
| **Sound** | Plays a sound when a block ends |

Changes save as you make them. Click a profile in the list to use it; switch profiles while the timer is stopped. To remove a profile, open its **⋯** and click **Delete profile** (there's always at least one). Drag profiles by the handle on the left to reorder them.

## Run a one-off countdown

For a single timer without breaks, click the time while the timer is stopped, type a length and press **Enter**. The timer starts right away and shows **Countdown**. You can type minutes (`45` or `45m`), hours (`1h`, `1h30m`) or seconds (`90s`), up to 24 hours. A countdown has only the stop and pause buttons, no skip.

![The timer ring showing Countdown and 09:58 with the Work profile](https://mintcdn.com/heym/n5OvCilbUvjGlsuj/images/pomodoro/countdown.webp?fit=max\&auto=format\&n=n5OvCilbUvjGlsuj\&q=85\&s=a97b8ecca3f92001fcab5dbeee665bff)

A 10-minute countdown

If you click somewhere else instead of pressing **Enter**, nothing starts: the clock shows the new length, and focus blocks use it until you pick a profile again.

## Good to know

* **Profiles stay on this device.** Your profiles and a running timer are saved in this browser or in the Mac app, not in your account, so another computer starts with the standard **Work** profile.
* **Reloading is safe.** If you reload the page or close Heym while the timer runs, it keeps counting. If a block ended while Heym was closed, it ends when you open Heym again.
* **After a reload, pick your profile again.** When you reload the page or open Heym with the timer stopped, the timer shows your profile's name but uses the standard lengths (25, 5 and 15 minutes, 4 sessions). Click the profile name under the clock, then click your profile, to use its own lengths.
* **There's no history screen.** Heym doesn't show a list or a chart of past focus sessions.
* **On the Free plan**, **Start Pomodoro**, **Start focus**, **G** then **F** and the command menu open the upgrade window instead of the timer.

## Limits

Focus blocks and breaks can each be 1 to 1,440 minutes long, and a round can have 1 to 10 focus sessions.

## Related

> [card] [Tasks](/help/tasks.md)
>
> Create the tasks you focus on.

> [card] [Keyboard shortcuts](/help/keyboard-shortcuts.md)
>
> G then F opens the timer.

> [card] [Reminders](/help/reminders.md)
>
> How notifications reach you and how to allow them.

> [card] [Free, Pro and Lifetime](/help/plans.md)
>
> What Pro adds, the timer included.


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