Habit Loop Help

Everything you need to build habits, protect your streaks and understand your progress

๐Ÿ”ฅ Streaks โ„๏ธ Freeze tokens ๐Ÿ“… Smart reminders ๐Ÿ”’ Private by default
๐Ÿ 

What is Habit Loop?

Habit Loop is a calm, focused habit tracker. You decide what you want to do regularly, tick it off when it's done, and Habit Loop keeps count. What makes it different is that it's built for real life: grace days, freeze tokens and streak recovery mean one missed day doesn't wipe out weeks of effort.

What you can do

โœ“
Track habits daily, on weekdays, or on the days you choose
โœ“
Tick off a habit with one tap, skip a day on purpose, or add a note
โœ“
Catch up on days you forgot to log (up to a week back)
โœ“
Protect your streak with grace days, freeze tokens and recovery
โœ“
Get a reminder at the time you choose, moved around your calendar with Pro
โœ“
See a consistency score, completion rates, your best day and milestones
โœ“
Export your full history to a spreadsheet at any time, free

The app has three tabs: Today (your habits for the day), Insights (your progress over time) and Profile (Pro, reminder settings and privacy).

๐Ÿš€

Getting started

There's no account and nothing to set up. Open the app and add your first habit.

1

Tap "Add a habit"

On first launch, Today shows a card with an Add a habit button. After that, use the blue + button in the bottom-right corner.

2

Name it and choose when

Pick an icon, give it a name, and choose Daily, Weekdays or Custom days. Set a reminder time if you'd like a nudge.

3

Allow notifications

The first time you save a habit with a reminder, iOS asks whether Habit Loop may send notifications. Choose Allow to get reminders. You can change this later in iOS Settings.

4

Tick it off

When you've done it, tap the circle on the right of the habit's card. That's your streak started.

๐Ÿ’ก Start small. Two or three habits you'll really do beat ten you won't. You can always add more once the first ones stick.

โœ…

The Today screen

Today is where you'll spend most of your time. From top to bottom:

PartWhat it shows
Date and titleThe day you're looking at. It says "Today" unless you've tapped another day in the strip.
๐Ÿ”ฅ Day streakYour overall streak: how many days in a row every habit scheduled that day was done, skipped or protected. See How streaks work.
Date stripThe last seven days plus tomorrow. Green days are ones where everything was done or protected. The dot underneath is green when the day is complete, red if something was missed, and grey otherwise. Tap a day to view it.
Progress ringHow much of the selected day is done, e.g. "3 of 4 done". Habits you skipped on purpose don't count against you.
Habit cardsEach habit scheduled for that day, with its icon, schedule, reminder time, current streak (๐Ÿ”ฅ) and a tick circle. Habits not scheduled that day (a weekday habit on a Saturday, say) aren't shown.
+ buttonAdds a new habit.

A small blue line under a habit's name tells you when something happened in the background, for example "โ„๏ธ Freeze token saved your streak", "Grace day saved your streak" or "Recovering ยท 1/3".

โž•

Adding a habit

Tap + on Today to open the New Habit sheet. Each option:

OptionWhat it does
IconPick one of the suggested emoji, or tap the dashed + tile and type any emoji from your keyboard.
Habit nameUp to 40 characters, e.g. "Morning Run" or "Read 20 pages".
Target (optional)A free-text goal shown under the habit's name, such as "5 km" or "10 minutes". It's a reminder for you; a habit is still simply done or not done.
FrequencyDaily = every day. Weekdays = Monday to Friday. Custom = the days you pick.
DaysThe days the habit is scheduled. Tapping a day while on Daily or Weekdays switches you to Custom, starting from those days.
ReminderTurn the switch on and tap the time to change it. You'll get a notification at that time on each scheduled day.
Smart scheduling (Pro)Moves the reminder if it would clash with a calendar event. See Smart scheduling.
Grace dayOn by default. Lets you miss a single day without breaking the streak, at most once every 7 days. See Streak protection.

Tap Create Habit to save. The habit starts today. Days before you created it are never counted as missed.

๐Ÿ’ก Scheduled days matter. A habit only expects you on its scheduled days. A Mon/Wed/Fri gym habit with three sessions done in a week has a perfect week, and its streak counts sessions, not calendar days.

โœ๏ธ

Ticking, skipping & notes

Mark a habit done

Tap the circle on the right of the habit card. It turns green with a tick, and your phone gives a little tap. Tap it again to undo.

Skip a day on purpose

Swipe the habit card to the left and tap Skip. Use this when you deliberately aren't doing a habit, for example when you're ill, travelling, or it's a rest day. A skipped day:

โœ“
doesn't break your streak
โœ“
doesn't add to your streak either
โœ“
isn't counted in your completion rate at all

A skipped habit shows a dash (โ€“) in its circle. Swipe and tap Skip again to un-skip it.

Add a note

Swipe the card left and tap Note to record something about that day, like "5.2 km, 28 min" or "rainy but went anyway". Notes appear in the habit's Recent list and in your CSV export. You can also add today's note from the habit's detail screen.

โš ๏ธ Skip honestly. Skips are unlimited because they're for genuine days off. If you skip whenever you don't feel like it, your streak stays alive but stops meaning much.

โช

Catching up on past days

Forgot to tick something off yesterday? Tap that day in the date strip at the top of Today. The screen switches to that day, and you can tick, skip or add notes exactly as you would today.

โœ“
You can change today and the previous 6 days.
โœ“
Tomorrow can be viewed (to see what's coming) but not ticked off.
โœ“
Tap today's date (the circled one) to go back.

๐Ÿ’ก Catching up fixes everything that depends on that day. If a freeze token had been used automatically to cover the day you forgot, ticking it off gives the token back.

๐Ÿ”ฅ

How streaks work

Habit Loop keeps two kinds of streak.

๐Ÿ”ฅ

Habit streak

Shown on each habit card and its detail screen: how many scheduled days in a row you've completed that habit. Unscheduled days are ignored.

๐ŸŒŸ

Day streak

The big number at the top of Today: how many days in a row every habit scheduled that day was done, skipped or protected. Days with nothing scheduled don't count either way.

A few rules worth knowing:

โœ“
Today is never a miss. Until midnight, a habit you haven't done yet is just "pending" and can't break anything.
โœ“
Today counts once it's done. Your streak goes up the moment you tick it off.
โœ“
Best streak on a habit's detail screen is the longest streak it has ever had.
โœ“
Streaks are always recalculated from your history, so editing a past day (within the last week) updates them immediately.
๐Ÿ›Ÿ

Streak protection

When a scheduled day passes without the habit being ticked off, Habit Loop tries to protect your streak automatically, in this order:

1

Skip

If you marked the day as skipped, it's neutral. Nothing else is needed.

2

Grace day

If the habit has Grace day turned on and you haven't used one in the last 7 days, the missed day is covered for free. The streak holds but doesn't grow.

3

Freeze token

If the grace day isn't available and the habit has a freeze token, one is used to cover the day.

4

Streak breaks

If nothing is left, the streak resets to zero, and recovery begins.

Grace days and tokens are only used when there's a streak to protect. They aren't wasted on a habit you haven't started yet.

Example: a daily habit with grace day on and 1 token.
Mon โœ“  Tue โœ“  Wed missed โ†’ grace day  Thu โœ“
Fri missed โ†’ freeze token (grace already used this week)  Sat โœ“
Streak on Saturday: 4, and still unbroken.
โ„๏ธ

Freeze tokens

Freeze tokens are earned by being consistent, and they're spent automatically when you need them.

QuestionAnswer
How do I earn one?Each time a habit's streak reaches a multiple of 7 (7, 14, 21 โ€ฆ), that habit earns 1 token.
How many can I hold?Free: 1 per habit. Pro: up to 5 per habit. If you're already full, a milestone doesn't add another.
Are they shared?No. Each habit has its own tokens.
How are they used?Automatically, on a missed scheduled day, after the grace day. You don't need to do anything.
How will I know?The next day, the habit card on Today says "โ„๏ธ Freeze token saved your streak", and the day shows as Frozen in the habit's Recent list.
Can I get one back?Yes. If you catch up on the day it covered (see Catching up), the token is returned.

Each habit's detail screen shows its tokens as โ„๏ธ tiles: bright tiles are tokens you hold, faded tiles are empty slots.

๐Ÿ”

Streak recovery

Sometimes a streak breaks anyway. Recovery is your way back.

1

The streak breaks

Your streak goes to 0, and the habit shows "Recovering ยท 0/3".

2

Do the next 3 scheduled days in a row

Skipped days pause recovery without ending it. Grace days and tokens can still protect you in the meantime.

3

Win back half

On the third day, half of your old streak is added back on top of the 3 days you just did.

Example: a 20-day streak breaks. You complete the next 3 days.
New streak = 3 + (20 รท 2) = 13 days, instead of 3.

โš ๏ธ Missing another day during recovery (with no grace day or token to cover it) ends the recovery, and the old streak is gone for good.

๐Ÿ”Ž

Habit details

Tap any habit card (not the circle) to open its detail screen.

SectionWhat it shows
CurrentThe habit's current streak.
Best streakIts longest streak ever.
CompletionDays completed รท scheduled days since you started. Skipped days and today (until it's done) are left out. Days covered by a grace day or token count as not completed: they protect the streak, not the rate.
RecoveringOnly shown while a recovery is in progress, with how many days are left and how many days you'll win back.
Freeze tokensTokens held and your maximum.
Last 12 weeksOne square per day, one column per week (Monday at the top, this week on the right). Colours are explained below.
Today's buttonsMark done today, Skip and Note, shown when the habit is scheduled today.
RecentThe last 10 scheduled days with their result and any note.

Heatmap colours

Bright (habit colour)Completed
BlueProtected by a grace day or freeze token
FadedSkipped on purpose
Dark redMissed
EmptyNot scheduled, or before the habit started

The โœŽ pencil in the top-right corner opens the edit sheet. See Edit, reorder & archive.

๐Ÿ””

Reminders

Each habit can have one reminder at a time you choose. Reminders are designed to be quiet and useful:

โœ“
They only arrive on the habit's scheduled days, so no weekend nags for a weekday habit.
โœ“
If you've already done or skipped the habit today, today's reminder is cancelled.
โœ“
The message mentions your current streak, e.g. "Keep your 12-day streak going".

Turning reminders on and off

โœ“
One habit: open the habit, tap โœŽ, and use the switch in the Reminder card.
โœ“
All habits: Profile โ†’ Reminders โ†’ Notifications.
โœ“
If Profile shows "Notifications are turned off for Habit Loop in iOS Settings", tap that message to open Settings and allow them.

๐Ÿ’ก Open Habit Loop every few days. iOS limits how many reminders an app can line up in advance, so Habit Loop plans the next several days each time you open it. With only a few habits that's two weeks ahead; with lots of habits it's less. Daily use keeps everything topped up automatically.

๐Ÿ“…

Smart scheduling PRO

Smart scheduling checks your calendar and moves a reminder that would land at a bad moment, so you don't get "Time to meditate" in the middle of a meeting.

Setting it up

1

Unlock Pro

Smart scheduling is part of Habit Loop Pro.

2

Turn it on in Profile

Profile โ†’ Reminders โ†’ Smart scheduling. iOS will ask for full calendar access. Habit Loop only reads events; it never adds, changes or deletes them.

3

Turn it on for each habit

Open a habit, tap โœŽ, and switch on Smart scheduling. That lets you choose which habits it applies to.

How a reminder is moved

โœ“
A clash is when the reminder falls during an event, or an event starts less than 30 minutes after it.
โœ“
The reminder first moves to 30 minutes before the event.
โœ“
If that time has already passed or is also busy, it moves to 5 minutes after the event ends (skipping past back-to-back events).
โœ“
It's never pushed into the next day. If there's no good slot, it keeps your original time.
โœ“
All-day events and events marked as "free" are ignored.
Example: reminder at 6:00 PM, meeting 6:15โ€“7:00 PM.
The meeting starts within 30 minutes โ†’ reminder moves to 5:45 PM.

Calendar changes are picked up whenever you open the app. Your calendar is read on your iPhone and never leaves it.

๐Ÿ“ˆ

Insights

The Insights tab shows how you're doing over a Week (Monday to today), a Month or a Year. Use the switch at the top to change period and the pill in the top-right corner to pick which month or year.

CardWhat it means
Consistency score0โ€“100: completed days รท scheduled days, across all your habits, for the period. 80+ is On Track ๐ŸŽฏ, 60โ€“79 Building Momentum ๐Ÿ“ˆ, below 60 Finding Your Rhythm ๐ŸŒฑ.
vs last periodHow your score compares with the previous week, month or year (green up, red down).
Completion rateEach habit's own rate for the period, in its own colour.
By day of weekYour completion rate for each weekday. The best day is highlighted, which is handy for spotting the day you tend to slip.
Best dayThe weekday you're most consistent on.
On trackHow many habits are at 80% or better for the period.
Top streakYour longest current habit streak.

On the free version you can see this week and this month. Past months and the Year view are part of Pro.

๐Ÿ†

Milestones

Milestones at the bottom of Insights mark real achievements. Ones you haven't reached yet are faded and show how far you have to go.

MilestoneHow to earn it
๐Ÿ† 7-Day WarriorComplete all your habits for 7 days straight (your day streak reaches 7). Counts how many times you've done it.
๐Ÿ”ฅ On FireReach a 21-day streak on any habit.
โšก Speed RunnerComplete all scheduled habits before 9 AM, 5 days in a row.
๐Ÿ’ฏ CenturyComplete 100 habits in total.
โฐ Your Golden HourDiscovered after 10 same-day check-ins: the hour you most often tick habits off.

๐Ÿ’ก Speed Runner and Golden Hour use the time you ticked a habit off, so they only count habits ticked on the day itself. Catching up on a past day never counts as "before 9 AM".

๐Ÿ—‚๏ธ

Edit, reorder & archive

Edit a habit

Open the habit and tap the โœŽ pencil. Change anything and tap Save Changes.

โš ๏ธ Changing a habit's days changes how its history is read. If you switch from Daily to Weekdays, past weekends stop counting as missed, which can lengthen a streak. Switching the other way can shorten it.

Reorder habits

On Today, press and hold a habit card, then drag it up or down. The new order is saved straight away.

Archive a habit

Archiving puts a habit away without losing anything. Open the habit, tap โœŽ, then Archive habit. It disappears from Today and Insights, stops reminding you, and no longer counts towards the free 3-habit limit. Its history is kept and still included in exports.

To bring it back, scroll to the bottom of Today and tap "N archived habits", then choose the habit to restore.

Delete a habit

Open the habit, tap โœŽ, then Delete habit. This permanently removes the habit and all of its history, and it can't be undone. If you might want the history later, archive instead.

๐Ÿ“ค

Export & backup

Your data is yours. Exporting is free for everyone. Go to Insights, scroll to the bottom, and tap Export CSV. Choose where to send the file from the share sheet: Files, Mail, AirDrop and so on.

The file has one row per scheduled day for every habit, including archived ones, with these columns:

DateThe day, as YYYY-MM-DD
HabitThe habit's name
StatusDone, Skipped, Grace day, Freeze token, Missed or Pending (today, not yet done)
NoteAny note you added
Completed atThe time you ticked it off, if you did so on the day

It opens in Numbers, Excel or Google Sheets.

โš ๏ธ Habit Loop has no cloud sync. Your habits live on your iPhone. If you delete the app, its data is deleted too. They're included in your normal iPhone backup (iCloud or computer) if you have one turned on, and restoring that backup to a new phone brings them back. For extra peace of mind, export a CSV now and then.

โญ

Habit Loop Pro

Pro is a single one-time purchase (ยฃ3.99 in the UK, or the equivalent in your currency). There's no subscription and no ads.

FeatureFreePro
HabitsUp to 3 activeUnlimited
Freeze tokensHold 1 per habitHold up to 5 per habit
Grace days, skips, recoveryโœ“โœ“
Remindersโœ“โœ“
Smart (calendar-aware) schedulingโ€“โœ“
InsightsThis week & this monthPlus past months & years
CSV exportโœ“โœ“

Buying and restoring

โœ“
Buy: Profile โ†’ Unlock Pro, then confirm with Apple.
โœ“
New phone or reinstall: Profile โ†’ Restore purchase. Pro is tied to your Apple Account, so you never pay twice.
โœ“
Family Sharing / Ask to Buy: if a purchase needs approval it shows as waiting. Use Restore purchase once it's approved.

If you have more than 3 habits and later restore from a backup without Pro, nothing is deleted. You just can't add or restore more habits until you unlock Pro or archive some.

๐Ÿ› ๏ธ

Troubleshooting

I'm not getting reminders

Check, in order: the habit's Reminder switch is on (โœŽ on the habit); Profile โ†’ Notifications is on; iOS Settings โ†’ Notifications โ†’ Habit Loop โ†’ Allow Notifications is on; Focus or Do Not Disturb isn't silencing it. Then open Habit Loop once so it re-plans your reminders. If you haven't opened the app for a couple of weeks, reminders may simply have run out. Opening it fixes that.

A reminder came at a different time from the one I set

That's smart scheduling moving it around a calendar event. Turn it off for that habit (โœŽ โ†’ Smart scheduling) or everywhere (Profile โ†’ Smart scheduling).

My streak looks wrong

Check the habit's Recent list and heatmap. A forgotten tick shows as Missed; you can fix it from the date strip on Today if it was in the last 7 days. Also check the habit's days: streaks only count scheduled days.

A freeze token disappeared

It was used to cover a missed day. Look for a Frozen entry in the habit's Recent list. If you actually did the habit that day, tick it off from the date strip and the token comes back.

Smart scheduling won't turn on

It needs Pro and full calendar access. Go to iOS Settings โ†’ Privacy & Security โ†’ Calendars โ†’ Habit Loop and choose Full Access ("Add Events Only" isn't enough to read your schedule).

I can't add another habit

The free version allows 3 active habits. Archive one you're not working on, or unlock Pro for unlimited habits.

Restore purchase says nothing was found

Make sure you're signed in to the App Store with the same Apple Account you bought Pro with (Settings โ†’ your name โ†’ Media & Purchases), then try again.

โ“

FAQ

Do I need an account?

No. There's no sign-up of any kind. Everything is stored on your device.

Is my data uploaded anywhere?

No. Your habits, notes and history stay on your iPhone. Smart scheduling reads your calendar on the device and sends nothing anywhere. We run no servers and use no analytics. See the Privacy Policy.

Can I use Habit Loop on my iPhone and iPad together?

You can install it on both, and Pro restores on both, but they don't sync: each device keeps its own habits.

Why can't I change days older than a week?

A week gives you plenty of time to catch up on genuine slips, while keeping your history honest. Older days are locked in.

Does it work with light and dark mode?

Yes. Habit Loop follows your iPhone's appearance setting automatically.

Is Pro a subscription?

No. It's a one-time purchase, yours for good.

How do I get help?

Email us at farabovestudios@gmail.com. We're happy to help.