Import a File

Most services let you download your own data as a file. Kaizora reads that file on your device and adds what’s in it to your history. This page covers what’s the same for every service; each service has its own guide, listed at the end.

Import a File

1. Open Data Sources, from the account menu at the bottom of the sidebar. Or search for “Import” from anywhere.
2. Under Imports, find the kind of file you have and choose Import from file (Import photos for Locations from Photos).
3. The dialog links to the guide for exporting that file, such as How to export from Apple Health.
4. Under File, choose the file (Photos, for your photos). Some imports ask for what the file doesn’t say: the Time Zone of times written without one (yours by default), a bank statement’s account and columns, or an Aranet4’s device and where it stood.
5. Choose Import. The dialog shows its progress, then how many entries it imported.

Apart from Apple Health’s export, which is read a piece at a time, a file can be up to 256 MB.

Your File Stays on Your Device

The file is read in your browser and turned into entries there; only those entries are saved to your account. The file itself is never uploaded or kept, and its name isn’t recorded.

Importing Again Is Safe

Each imported entry remembers which record at the source it came from. Import a newer export and the readings you already have are updated, not added twice, and new ones are added. Importing the same file twice adds nothing new. To stay up to date, export again from time to time and import the newer file.

A reading deleted at the source isn’t removed by importing again, except for Cronometer’s, whose file replaces the days it covers.

The Same Reading From Two Services

Apps share data: your scale’s app may write your weight to Apple Health too. Kaizora keeps each service’s entries apart and handles the overlap:

• Apple Health skips apps with their own import. Once you’ve imported Withings or Cronometer directly, their copies in your Apple Health export are left out.
• Totals count once. For a metric that adds up, such as steps or time asleep, a day’s total counts everything you logged yourself plus the one imported service with the largest total. See Why Is My Sleep Counted Once When Two Devices Recorded It?

Imported Entries Are Read-Only

An imported entry stays as the source has it, since the next import would bring it back anyway. You can change its notes, and an imported transaction’s category. See Edit or Delete an Entry.

See How an Import Went

History, at the top of Data Sources, lists every sync and import: when it started, whether it Succeeded or Failed, how many entries it logged, and any error. Each source’s … menu has See history, for its own. If an import fails, fix what the error says and import the same file again; what it had already written is updated, not doubled. See Why Was My File Refused?

Each Service

• Apple Health
• Withings, or its live connection
• Cronometer
• Bank statements (CSV)
• Calendar files
• Google Maps Timeline
• Locations from Photos
• Aranet4

To remove what an import brought in, see Delete What a Source Brought In.