Frequently Asked Questions

Why is long pressing the category no longer adding an event?

This gesture had to be removed in v1.2.13 in order to fix some issues around list selection in the underlying framework. It is replaced by an option to add an event whenever the icon is tapped, which can be enabled in Settings.

Is there an import/export option?

I recommend using the Shortcuts integration to import and export data. This allows you to customize the exact data format to suit you. Here are some example shortcuts to get started:

Export Category – export a csv file of events for a single chosen category, no configuration required.

Export All Categories – export a csv file of all events for all categories, no configuration required.

Import Category – this is a template for the type of Shortcut needed to import data into Chronicling, but will need to be modified to match the format of your data. Depending on the size of the input file, you may need to enable “Allow Sharing Large Amounts of Data” in Settings.

Import from Done – this shortcut is an example of the Import Category shortcut above customised to support the csv format exported by the Done app. It creates all necessary Categories (for habits) and Groups (requires Premium).

My “Find…” Shortcuts are not filtering by Category/Group properly

There is a bug in iOS 17 that has broken filtering the results from “Find” Shortcuts actions by other types (e.g. a Category or Group chosen from the suggestions in the drop down). This is resolved in the latest iOS 17.2 beta, but in the mean time, it is possible to work around this by passing in a variable rather than selecting an option from the menu, like in this example.

Why isn’t sync working?

To sync data between devices automatically, each device must be logged into an iCloud account with iCloud Drive enabled.

The watchOS app isn’t loading

The watch app relies on iCloud sync to share data with the iOS/iPadOS apps. On first launch, it can take a little while to sync your categories, as indicated by the loading spinner. Please leave the app open for a minute or so to complete this first time sync. If it still fails to load, please get in touch!


If you have any questions not answered here, or feedback about the app, please email me at