Define trackers

Replace a metric

Change a metric without losing its history

The short version

  • A metric’s kind of value and how it combines are set when it is created.
  • To change them, add a new metric, copy the old one’s history into it with Export and Import, then deprecate or delete the old one.
  • Nothing is lost along the way: the import only fills in the new metric.

Why a new metric?

Your stats are built on how each metric was set up, so its kind of value and how it combines are locked once it exists. Say Steps was set to be averaged and you would rather add it up, or Mood was a number and should be a choice from a list: add a new metric set up the way you want, and give it the old history.

Copy the history in five steps

1. Add the new metric

Open the tracker’s ⚙ settings, add the new metric with the setup you want, and save. Give it a different name for now, like “Steps (total)”.

2. Export the full history

In the tracker’s ⋮ menu, choose Export cards to CSV, for all dates. A very long history may come as more than one file: repeat the next steps for each.

3. Keep only the old metric’s column

Open the file in a spreadsheet. Delete every column except Date (and OccurrenceTime, if the tracker is logged anytime) and the old metric’s column. Then rename that column to the new metric’s name.

4. Import with Overwrite

In the ⋮ menu, choose Import cards from CSV and pick the file. The renamed column matches the new metric; check that no other metric is matched to it. Every row matches an entry you already have, so on the review step choose Overwrite all.

Overwrite only changes the metrics that have a column in the file. The new metric is filled in on every past entry, and every other value stays exactly as it was.

5. Retire the old metric

A deprecated metric keeps its name, so the new one can take the old name only once the old one is deleted. If a calculated metric uses the old one, the editor lists it when you deprecate or delete.

Example: Steps, averaged → added up

Add “Steps (total)” set to add up.

Export, keep Date and Steps, rename Steps to “Steps (total)”.

Import, Overwrite all: every past day now has Steps (total).

Deprecate Steps to keep its old averages, or delete it and rename “Steps (total)” to “Steps”.

A calculated metric needs none of this

A new calculated metric is worked out for every past entry by itself. Add it, and the history fills in on its own.

Related guides