HabitKit Backups: How To Restore Your Data
By Sebastian Röhl, creator of HabitKit
8 min read Published Updated Instructions for HabitKit 1.19.0
HabitKit backs up automatically in two places. On every phone, once a day, it writes a full snapshot of your data to the phone itself and keeps the last seven. On iPhone, since version 1.18.2, it also saves a daily backup to your own iCloud, and on Android, since 1.18.3, it can do the same to your Google Drive once you turn it on. That copy survives losing or replacing the phone. Restoring any of them is free.
The on-device snapshots sit next to your data, on the same device. They help after a bad import or a database that stops opening, but they go when the app or the phone does. The iCloud or Google Drive backup, or an exported file you keep somewhere else, is the copy that survives that.
On this page
iCloud Backup On iPhone
The iCloud backup runs once a day, when you open the app. There is nothing to sign in to: it uses the Apple Account and iCloud Drive already on your iPhone, and the files count towards your iCloud storage.
- New installs switch it on by themselves when you create your first habit, and say so.
- If you updated from an earlier version, What's New offered to turn it on. You can always do it in Settings › Backup & Restore › Turn on iCloud backup.
- HabitKit keeps the last 5 backups from this iPhone, one for each of the five most recent days you opened the app. Each one holds all your habits and check-ins. Backups from your other iPhones are kept separately and never touched.
- The files are in iCloud Drive › HabitKit, which you can see in the Files app.
- Back up now on the Backup & Restore screen makes one straight away.
The status card at the top of Backup & Restore says how it's going: "Your habits are backed up" with the date of the last backup, "Almost there" while iCloud is still uploading, or what's wrong, such as "iCloud Drive is off" or "Your iCloud storage is full". If backups stop for a week, a card on the overview tells you. Turning backup off keeps your existing backups in iCloud; no new ones are saved.
On Android, since version 1.18.3, HabitKit can back up to your own Google Drive once a day in the same way. Turn it on in Settings › Backup & Restore › Turn on Google Drive backup. HabitKit keeps the last 5 backups from the phone, in Google Drive › HabitKit. An export is still the way to keep a copy anywhere else (export and import your habit data).
The Daily On-Device Backup
The on-device backup runs a couple of seconds after the app finishes launching, and only if at least a day has passed since the last one. There is no background schedule, no server, and no account.
- Seven daily snapshots are kept. The eighth pushes out the oldest.
- They are written only when you open the app. Skip a fortnight and you have a fortnight-old newest backup, not a fresh one. The count is seven files, not seven days.
- HabitKit saves a separate snapshot immediately before each import or restore, and three of those are kept on their own budget, so a run of imports can never evict your week of daily history.
- The snapshots are local files. They live in HabitKit's own folder. Deleting the app deletes them. Your operating system may include them in a device backup.
That last point is why the iCloud backup and export exist. An on-device backup protects your data from the app. A copy off the phone protects it from losing the phone.
Restore A Backup
Open Settings › Backup & Restore and tap Restore a backup. The sheet is the same on iPhone and Android, with three sources:
- Your cloud backups, under iCloud Drive on iPhone or Google Drive on Android, newest first, each showing when it was made and the phone it came from. On iPhone each also shows its habit count. On Android, if Google Drive isn't connected yet, tap Connect Google Drive and choose the account you backed up with.
- On this phone, with the on-device snapshots, including the copies saved before earlier restores. "Saved inside HabitKit. Deleting the app removes them." Before the first backup the list says "No backups here yet.", which is not a fault.
- From a file, for a copy you exported yourself.

The Restore a backup sheet on Android. On iPhone the cloud backups are listed under iCloud Drive instead.
Each row shows when the backup was written, newest first, and tapping it starts the restore. Pick the newest one that predates whatever went wrong.
Restoring is free, like export and import. A restore brings back habits, check-ins with their notes, goals, reminders and categories, but not app settings, and restoring a Pro purchase brings back no habits.
Archive A Habit Instead Of Deleting It
A habit that has run its course does not have to be deleted. Archiving is the reversible option, and it is worth knowing about before you reach for the other one.
Archive from the habit card's context menu, or from the menu on the habit's detail page. Confirm "Do you really want to archive this habit?" and it is done.
Archiving flips a single flag. Nothing is deleted: completions, notes, goals, reminders and category assignments all stay exactly where they were. What changes is what you see.
- The habit leaves your overview, so its grid and streak are no longer on screen.
- Its reminders stop firing.
- It drops out of home screen widgets and out of the pickers that build them.
- It is still included in every export and every automatic backup.
Archived habits live at Settings › Archived Habits, one list with a Restore button on each habit. Restore is a Pro feature, because restoring can put you back over the four habits the free tier allows. To delete one, swipe left on it and confirm. Deleting is free, and it means it: "It goes for good, with all its history. This can't be undone." The only way back is a backup or an export.
If The App Cannot Open Your Data
If HabitKit cannot open its database when it starts, it shows a recovery screen instead of hanging on the splash. The screen says "Your data couldn't be opened", and explains that HabitKit couldn't open its database, that your habits are still stored on this device, but that the app can't read them right now.
It offers two steps, and they are worth trying in this order.
- Try again. Closes the failed attempt and opens the database from scratch. A transient failure, such as a full disk or a file locked at the wrong moment, often clears here. Try this first, twice if you like.
- Restore this backup. HabitKit reads the automatic snapshots on the device, daily or pre-import, newest first, and offers the first one it can use, with its date and its habit and check-in counts. Restoring sets the unreadable database aside, keeping it on the device, and brings your habits back from that snapshot.
The restore button only appears once a snapshot has been read and checked. If none on the device can be used, the screen says "No usable backup was found on this device. Your stored data has been kept.", and nothing is moved or replaced. Once the app opens again, a restored snapshot can be swapped for a different one: under Settings › Backup & Restore › Restore a backup › On this phone, where your iCloud or Google Drive backups are listed too. Or contact support. Do not uninstall the app: that removes the files which may still help recover your history.
If neither step gets you back in, HabitKit will not open, or shows an error covers what to send us so we can work out what happened. And if you are about to change devices, read move your habits to a new phone first.
Related Questions
How Many Backups Does HabitKit Keep, And For How Long?
On the phone, seven daily snapshots, plus three written immediately before an import or restore, on a separate budget. On iPhone, iCloud also holds the last five daily backups from each iPhone; on Android, Google Drive holds the last five from the phone. Backups are only made on days you open the app, so they can cover more than a week if you skipped some days.
Do Backups Upload Anywhere?
Yes, if you turn it on. On iPhone, once a day to iCloud Drive › HabitKit in your own iCloud. On Android, since 1.18.3, once a day to Google Drive › HabitKit in your own Google account. The on-device snapshots never leave the phone.
Is Restoring A Backup A Pro Feature?
No. Restoring a backup is free for everyone, and so are export and import. They are a safety net for data you already had, not a paid feature.