Import Your Data

Already tracking habits elsewhere? Import your history in minutes.

Download the template

The app provides a ready-made CSV template via Settings → Data Management → Download Template. It includes the correct column headers and a few example rows to guide you.

Or download the template directly here:

Download template (CSV)

Template format

date,habit,unit,value,note
2026-01-15,Sleep,hours,7.5,
2026-01-15,Workout,minutes,45,Leg day
2026-01-16,Running,km,6.2,Morning run

Fill in your data

Open the template in Excel, Google Sheets, or Numbers — then fill in your rows. Save or export as .csv or .txt when done.

daterequired

YYYY-MM-DD format. Example: 2026-03-15

habitrequired

Must match an existing habit name in the app (case-insensitive). Example: Sleep, Workout, Running

unit

The habit's unit — for your reference. Examples: hours, minutes, km, kcal, liters

valuerequired

Numeric, must be 0 or greater. Example: 7.5

note

Optional free text. Leave blank or omit entirely.

Import in the app

1Go to Settings → Data Management → Import CSV
2Select your file from the Files app
3Review the preview — it shows how many entries will be imported and flags any errors
4Tap Import to confirm

Tips & common questions

→

If a date + habit combination already exists, the import will update the existing value — not duplicate it.

→

Habit names must match exactly: 'Workout' and 'workout' both work, but 'Work out' won't match 'Workout'.

→

You can mix multiple habits in a single file — just add rows for each.

→

The app also accepts .txt files with the same comma-separated format.

→

There's no limit on the number of rows you can import at once.

Ready to import?

Download template