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

# Track habits and build streaks

> Set when a habit happens and how much counts, check it off day by day, and read your streak and stats. Covers 3 times a week, skip and fail.

A habit is something you want to do again and again, like practicing a language every morning or going to the gym three times a week. You decide when it happens and how much counts, then check it off on the days you do it. Heym keeps the history and turns it into a streak, a completion rate and a calendar. This page covers creating habits, schedules and targets, checking them off, the stats, and archiving or deleting.

![The Habits page for the week of November 2 to 8, with habits grouped under their life areas. Each habit has a square for every day of the week, checked on the days it was done, and a progress bar for the week](https://mintcdn.com/heym/n5OvCilbUvjGlsuj/images/habits/habits-list.webp?fit=max\&auto=format\&n=n5OvCilbUvjGlsuj\&q=85\&s=c61b89e9a48af655400e994ca63f7f56)

The Habits page shows one week at a time

## Create a habit

**1. Open Habits**

Click **Habits** under **My Life** in the sidebar, or press **G** then **H**.

**2. Click New habit**

Click **New habit** at the top right. The new habit opens in a window.

**3. Name it**

Type a name in place of **New habit**. To add detail, point at the space above the name and click **Add description**. Click the icon to change it or its color. In the color list, turn on **Inherit color** to use the color of the goal or life area the habit is aligned to.

**4. Link it to what it serves**

On the right, click **Alignment** and choose a goal or a life area.

A new habit repeats every day and counts as done with one check-in a day (**1 / day**). Change that with **Target** and **Schedule**, described below.

To change a habit later, click its name on the **Habits** page to open its window.

You can also add a habit from a goal's or life area's page: click **Add habit** in its **Habits** section. The habit is linked to that goal or area for you.

![The window for the habit Portuguese practice. At the top, Wednesday, Nov 4 with a checked square and the label Done. Below, four boxes: Current streak 15, Completion rate 83%, Perfect weeks 6, Skipped (30d) 5, then a Progress chart for the week. On the right: Alignment, Target 1 / day, Schedule Every day, 8:15 AM, and Reminders](https://mintcdn.com/heym/n5OvCilbUvjGlsuj/images/habits/habit-window.webp?fit=max\&auto=format\&n=n5OvCilbUvjGlsuj\&q=85\&s=8f3516f969e9d1ee2be6149da4c91d90)

A habit's window: today's check-in, stats and history on the left, settings on the right

## Choose how much counts

Click **Target** in the habit's window to set what a successful day, week, month or year looks like.

![The Target menu with the rows Target 1, Unit type Count, Period Day, and an Enter value switch turned off](https://mintcdn.com/heym/n5OvCilbUvjGlsuj/images/habits/target-menu.webp?fit=max\&auto=format\&n=n5OvCilbUvjGlsuj\&q=85\&s=c5b03be8b1d02b65b1100addb0e8412f)

| Option | What it does |
| - | - |
| **Target** | How many or how much, such as 1, 8 or 10000. |
| **Unit type** | **Count**, **Calories**, **Distance**, **Time**, **Water**, **Steps**, **Pages**, **Chapters**, or **Custom** for your own unit (up to 20 characters). |
| **Unit** | Appears for types with more than one unit: **Distance** (km, mi), **Time** (hours, minutes, seconds) and **Water** (ml, oz, glasses). |
| **Period** | **Day**, **Week**, **Month** or **Year**: the stretch of time the target covers. |
| **Max per day** | How much one day can add to a weekly, monthly or yearly target. Appears only for **Count** habits with **Enter value** turned off. Choose **1×** to **10×**, or **No limit**. |
| **Enter value** | When it's on, checking the habit off asks you for a number, such as 30 pages, instead of adding 1. |

### A few times a week, month or year

For "gym 3 times a week", set **Target** to 3 and **Period** to **Week**. The habit then counts any 3 days in the week, and it reads **3× / week**.

When you switch a **Count** habit from **Day** to a longer period, **Max per day** starts at **1×**, so each check-in has to be on a different day. Choose a higher number, or **No limit**, if one day may count more than once.

![The Target menu for a habit set to 3× / week: Target 3, Unit type Count, Period Week, Max per day 1×, and the Enter value switch](https://mintcdn.com/heym/n5OvCilbUvjGlsuj/images/habits/weekly-target.webp?fit=max\&auto=format\&n=n5OvCilbUvjGlsuj\&q=85\&s=f5c496c3132a2c04b8191228a6b65b44)

3 times a week: Max per day 1× means three different days

## Set when it happens

Click **Schedule** to choose the habit's days and time.

![The Schedule menu showing a start date of Jun 7, 2026 in a calendar, then Start time 8:15 AM, Duration 20 min, Time zone Denver, an Include end date switch, Repeat Every day and Clear. Next to it, the Repeat options Daily, Weekly Sunday, Monthly 7th, Yearly Jun 7th, Every weekday Mon to Fri, and Custom](https://mintcdn.com/heym/n5OvCilbUvjGlsuj/images/habits/repeat-menu.webp?fit=max\&auto=format\&n=n5OvCilbUvjGlsuj\&q=85\&s=d24370c64f5b6980e2916470dbd0a4cc)

The Schedule menu, with the Repeat options open

* **The date and calendar**: the day the habit starts. **Include end date** adds a last day.
* **Start time** and **Duration**, such as 8:15 AM for 20 minutes. A habit with a time sits at that time on the [calendar](/help/calendar.md).
* **Time zone**: keep a city, or choose **Floating** to follow your local time.
* **Repeat**: **Daily**, **Weekly**, **Monthly**, **Yearly**, **Every weekday** or **Custom**. Weekly, Monthly and Yearly follow the start date's weekday or date.

**Custom** repeats every few days, weeks, months or years, on the weekdays or dates you choose. It works as for tasks (see [Repeating tasks](/help/repeating-tasks.md)), without the **Based on** and **Ends** options.

> [!NOTE]
>
> **Repeat** appears only when the target's period is **Day**. A habit with a weekly, monthly or yearly target can be done on any day of the period, so it has no repeat rule.

## Check off a habit

On the **Habits** page, each habit has a square for every day it's scheduled. Days it isn't scheduled show just the letter and can't be checked off. Click a day's square:

* **Yes or no habits** (the default **1 / day**): one click marks the day done. Click again to undo it.
* **Count habits**: each click adds 1. On a weekly, monthly or yearly habit, once a day reaches its **Max per day**, the next click clears it. To clear a day's count, right-click the square and choose **Reset progress**.
* **Enter value** turned on: a small box asks for the amount.

<video autoPlay muted loop playsInline src="https://mintcdn.com/heym/RxdohfEkT1hOgZzU/videos/habits/check-off-today.mp4?fit=max&auto=format&n=RxdohfEkT1hOgZzU&q=85&s=ff9142a48eaf9651fb7a61f1b34c2207" aria-label="Pressing G then H opens the Habits page. Clicking Wednesday's square for Portuguese practice fills it with a check, and the habit's progress for the week goes from 29% to 43%" />

Press G then H for Habits, then click today's square

Use the arrows at the top to change the week, and click the dates between them to come back to this one. Days that haven't happened yet can't be checked off.

You can also check off today's habits on **Home**, in **Today's habits**, and habits on the calendar in Today or Upcoming. See [Plan on the calendar](/help/calendar.md).

Right-click a square for more:

![A habit's week of squares with the menu open on a day that's already done: Complete (grayed out), Enter value, Skip, Fail and Reset progress](https://mintcdn.com/heym/n5OvCilbUvjGlsuj/images/habits/cell-menu.webp?fit=max\&auto=format\&n=n5OvCilbUvjGlsuj\&q=85\&s=e910b41d095638659f311e648056cbfb)

**Complete** fills the day in one go, **Enter value** asks for an amount, **Skip** and **Fail** mark the day (choose the same one again to take it back), and **Reset progress** clears it.

A habit's window does the same for today at the top: click the square to check in, or the buttons on the right to skip (**»**) or fail (**×**). The label next to the date says **Done**, **Skipped** or **Failed**.

## Done, skipped or failed

| Mark | Streak (daily habits) | Completion rate |
| - | - | - |
| **Done** | Adds a day. | Counts as done. |
| **Skipped** | Skipped over: the streak carries on. | Left out of the count. |
| **Failed** | Ends the streak. | Counts as not done. |
| Nothing, after the day is over | Ends the streak. | Counts as not done. |

Today doesn't break a streak while it's still open. Use **Skip** for a day that shouldn't count, such as a sick day, and **Fail** to record a miss. For weekly, monthly and yearly targets, only done check-ins add up; a skipped or failed day adds nothing.

## Read your streak and stats

The four numbers at the top of a habit's window:

| Stat | What it counts |
| - | - |
| **Current streak** | Scheduled days in a row you've done it. For weekly, monthly or yearly targets: periods in a row where you hit the target. |
| **Completion rate** | The share of scheduled days in the last 30 days, today included, that you completed, leaving out skipped days. For weekly targets: the share of the last 5 weeks, this one included, where you hit the target. For monthly and yearly targets, it covers only the current month or year, so it reads 0% until you hit that target. |
| **Perfect weeks** | How many of the last 12 weeks, this one included, were perfect. For weekly targets: the weeks where you hit the target. Monthly targets show **Perfect months** instead: how many of the last 3 months, this one included, hit the target. |
| **Skipped (30d)** | Scheduled days in the last 30 days, not counting today, that you skipped or left empty. On a habit with a daily target above 1, days that fell short of it count too. Weekly targets show **Missed weeks** instead: how many of the 4 weeks before this one missed the target. Monthly targets show **Missed months**. |

Below them, **Progress** charts your check-ins. **W**, **M**, **Q** and **Y** show this week, month, quarter or year; **4W**, **12W** and **12M** show the last 4 or 12 weeks or 12 months. Every range but **W** adds a **Calendar** of each month, where you can check off past days too.

## Get reminders

Click **Reminders** in the habit's window and choose when you want a nudge, such as **At start** or **On the day at** a time. A habit reminds you on each scheduled day until you've done it that day, or, with a target such as 3 times a week, every day until you reach the target. It stays quiet on days you skip or fail. How reminders arrive is on [Reminders](/help/reminders.md).

## Group and reorder habits

Click **View settings** (the sliders button next to **New habit**) to change the list:

* **Group**: **None**, **Life area**, **Goal** or **Time of day**. Habits are grouped by life area until you change it.
* **Show archived**: adds an **Archived** group at the bottom.

**Time of day** sorts habits by start time: **Morning** (5 AM to noon), **Afternoon** (noon to 5 PM), **Evening** (5 PM to 5 AM) and **Anytime** (no start time).

To reorder, point at a habit and drag the handle left of its name. Dragging it into another group moves it there. Dropped into **Morning**, **Afternoon** or **Evening**, it gets a start time of 8:00 AM, 2:00 PM or 7:00 PM; dropped into **Anytime**, it loses its start time.

## Archive or delete a habit

To pause a habit and keep its history, click its handle and choose **Archive**, or choose **Archive** in the **⋯** menu of its window. An archived habit leaves your list and becomes read-only. To bring it back, turn on **Show archived** in **View settings**, then choose **Restore** from its handle or its window.

To delete a habit, click its handle or the **⋯** menu in its window, choose **Delete**, then confirm with **Delete**.

> [!WARNING]
>
> **Delete** removes a habit and all its completion history for good. Heym asks you to confirm, and it can't be undone: deleted habits don't go to Trash. See [Undo and Trash](/help/undo-and-trash.md).

## Good to know

* **Habits don't move goal progress.** Linking a habit to a goal shows it on the goal's page, but the goal's progress comes from its tasks, subgoals or the numbers you log. See [Goals](/help/goals.md).
* **Habits aren't shared.** When you share a goal or life area, the habits in it stay private to you. See [Share with others](/help/sharing.md).
* **Repeating task or habit?** A repeating task is a to-do that comes back. A habit is a routine you track over time. See [How Heym fits together](/help/how-heym-works.md).

## Limits

The Free plan includes up to 3 habits, and archived habits count toward them. Pro has no limit. If you have more habits than your plan allows, for example after Pro ends, the extra habits become read-only and a banner in their window says so. Nothing is deleted. See [Free, Pro and Lifetime](/help/plans.md).

## Related

> [card] [Reminders](/help/reminders.md)
>
> Get a nudge when a habit is due.

> [card] [Calendar](/help/calendar.md)
>
> See habits on their days next to your tasks.

> [card] [Goals](/help/goals.md)
>
> Link habits to the goals they serve.

> [card] [Repeating tasks](/help/repeating-tasks.md)
>
> For to-dos that come back on a schedule.


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