← Back to support
Help

JSON backup: exporting your habits to a file and importing them again

Last updated:

With the JSON backup, Habit Tracker Grid saves your habits, history included, to a file. Where the file goes is your choice. Later you bring it back in with “Import from JSON”, on a new iPhone for instance.

Export and import work without Premium too. If the file holds more than 2 habits, the first 2 are active after an import without Premium. The others stay saved and come back with Premium. What Premium costs is on the pricing page.

Exporting a backup

  1. Open the “Settings” tab and tap “Export to JSON” under “Backup & data”.
  2. The iOS share sheet opens. Choose where the file goes, for example the Files app.

The file name starts with “habit_tracker_backup_” and ends in “.json”. Apple explains how to find the file again by its name in the Files app.

Importing a backup

  1. Open the “Settings” tab and tap “Import from JSON” under “Backup & data”.
  2. Pick your backup file.
  3. The app asks “Replace all data?”. Tap “Replace”.

The app then tells you how many habits it imported.

The import replaces what is in the app

The confirmation already says so: “This replaces your current habits and their history with the contents of the backup. Your existing data cannot be recovered afterwards.” The habits from the file replace the ones in the app, nothing is merged. If you want to keep what is in the app right now, export it as a separate file first.

More than 2 habits without Premium

If the file holds more than 2 habits and you do not have Premium, the app first offers you Premium. If you subscribe there, the app imports all of them. Otherwise the first 2 are active, and a note titled “Habit limit reached” tells you: “Without Premium, the first 2 are active. The others stay saved and come back as soon as you have Premium.”

The first 2 are the two that sat at the top of your list when you exported.

If you get Premium later, the other habits return to your list automatically, and the app tells you so. You do not need to import the file again.

Good to know

  • The file only goes where you send it from the share sheet. We never receive it.
  • For a backup that runs on its own, there is the iCloud backup.
  • What changes when your subscription runs out is covered in When Premium ends.