Log a pain episode

Record when an episode started, how it felt and what you were doing, on the device you have to hand.

Wireframe of the episode form: a start-time field, an intensity slider, and a notes box above a save button.

Open the episode form

Where the form lives differs by app. On the web app, choose Logging in the main navigation and use the Pain check-in card. On iPhone and Android it is closer to hand: Log pain sits on the Today screen, with no navigation step at all.

On the web app and iPhone, the form opens with the current time filled in, so an episode you are logging as it happens needs no date entry. On iPhone, the start time is under More details, along with the note box. On Android there is no time to set: the episode is recorded as starting at the moment you save it, so log it there while it is happening.

Record what you can

An episode is saved with four things: when it started, an intensity from 0 to 10, a body area, and how the pain feels. Only your own notes are optional.

On the web app and iPhone, the form opens with no intensity, body area or feeling chosen, and saving stays unavailable until you have picked all three, so nothing is recorded that you did not choose. On Android, the form opens with an intensity, a body area and a feeling already selected so a quick entry is a few taps rather than a blank page, and whatever is showing when you save is recorded as what you observed — so on Android, set each one before you save rather than leaving it.

Relief is added after you save, on the web app or iPhone. On the web app, open the episode in Timeline and it offers Record relief: what helped, when the relief happened, and an optional note. On iPhone, an episode that has not ended offers Mark relief and End episode, both on the Today screen while it is open and in its entry in Timeline. Android has no relief option: tapping an episode in Timeline there shows its details and a Done button and nothing else, so if you log an episode on Android and want to record what helped, do that part on the web app or iPhone.

Log without a connection

On iPhone, the form works offline: an episode saved with no connection is held on the device and uploaded the next time the app reaches the server, so nothing is lost and nothing is retyped.

On Android, the form also saves offline and the episode appears in your timeline straight away — but it is not queued for upload. A quick-logged episode that failed to reach the server stays on that phone only: reconnecting does not send it, and it is absent from the service and from your other devices until you log it again somewhere with a connection. The Sync card on Today then reads "Saved locally; sync pending" and counts an item waiting to upload, but that entry is still not sent later. If the entry matters, check that it is on another device once you are back online.

The web app has no queue at all. It saves straight to the server, and when that fails it says so and leaves what you entered on screen for you to try again — so stay on the page until a web entry has saved.

Correct or delete an entry

On the web app, open the episode in Timeline. Edit entry changes its intensity, feeling and note; its body area and start time cannot be changed there. Delete entry removes it after you confirm.

On iPhone, open an episode from Timeline. Edit entry changes its intensity, feeling, body area and note; its start time cannot be changed afterwards. Delete entry removes it, and the app offers an undo straight afterwards in case you did not mean to.

On iPhone, a deletion reaches your account. Once the undo is no longer offered, the app asks the service to delete the episode as well, so it leaves your record and your other apps rather than only that phone. A deletion made with no connection is held on the phone and sent the next time the app reaches the server.

On Android, long-press an episode in Timeline and confirm to delete it, and the app then offers Undo — but an Android deletion is local to that phone. As the confirmation says, it removes the entry from your local diary: that device's copy of your record loses it, but the service is not asked to forget it, so an episode that had already synced stays on the service and on any other app you are signed in to. Deleting on Android is tidying that screen, not removing the entry from your health record — if that is what you need, treat it as a data request rather than a delete, and contact support.

On Android, a saved episode cannot be edited, so check the intensity, body area and feeling before you save rather than planning to correct them later.