How The Habit Grid Works

The layout runs like a calendar turned on its side. Rows are weekdays and columns are weeks. Month and weekday labels help you find your bearings on a habit's detail page. Labels on overview cards are optional Pro customisations.

How far back the grid reaches depends on your recorded history:

• With less than a year between your first and most recent logged completions, it starts 365 days before the most recent one.
• With a longer history, it starts at your earliest completion.
• On sufficiently wide screens, the shorter-history window starts two years before the most recent completion instead.

The grid then extends through the current week. That means a habit you have not logged for a long time can show more than a year's worth of columns. A day carrying only a note does not extend the history boundaries.

A simplified grid with Monday as the first row. Each column is a week and each tile is one day.

For a habit you are building:

• Empty track. Nothing logged on that day.
• Partial colour. Some progress, but the daily goal has not been reached. There are five partial shades, growing stronger at 20%, 40%, 60% and 80% of the goal.
• Full colour. You met or exceeded the daily goal.
• Very faint tiles. Future days and days before tracking began are visually subdued.

With a daily goal of six, logging one, two, three, four or five each produces a different partial shade. Six fills the tile completely. With Yes / No tracking, the day is simply empty or complete.

An illustrated six-completion goal: empty, five partial shades, then full colour.

For a habit you are quitting, the meaning reverses. Yes / No shows clean days filled and slips empty. Count and Measure show the allowance remaining under your Stay Below: zero logged is full, amounts below the maximum fade progressively, and reaching the maximum makes the day empty. See track a habit you want to quit.

If a day looks wrong, check a day you completed looks empty or missing.

Two settings live at Settings › General.

Week Starts On sets the first row. All seven days are available and the default is Monday. Changing it also moves the boundaries used to count weekly Streak Goals.

Highlight current day is off by default. Turn it on to outline today's tile in grids and home screen widgets.

The overview's month and weekday labels live at Settings › Overview › Dashboard Customization and require Pro. A habit's detail grid has its own labels. See what HabitKit Pro unlocks.

Sharing a grid is free. HabitKit creates a PNG for the system share sheet.

1. Open the habit's context menu on the overview, or the gear menu on its detail page.
2. Choose Share Habit.
3. Adjust Appearance: choose a Light or Dark theme, a colour and whether to show the completion indicator. Description and streak options appear when the habit has those details to show.
4. Tap share and choose where to save or send the image.

The image contains the habit's icon or emoji, name, grid and any optional details you left enabled. Where it goes depends on the destination you choose in the share sheet.