Browse the guides

Logging a Workout

Starting a workout#

From the Train tab, you can start a workout two ways:

  • From a template — open a Plan, open a Template, and tap Start workout. This copies that template's exercises and targets in as your starting point for this session.
  • Freeform — tap Start freeform workout on the Train tab to begin with nothing planned, and pick exercises as you go. This is useful when you're improvising, don't have a template for what you're doing, or just don't feel like planning ahead.

Once logging starts, freeform and template-started workouts work exactly the same way from here on.

Only one workout can be in progress at a time. If you background the app, relaunch it, or navigate away mid-workout, Datum doesn't lose track of it. If you try to start a workout from a different template or plan (or a freeform one) while one's still going, Datum won't silently swap it out from under you — it asks first, so you can either jump back into what's already running or finish it and start the new one:

A confirmation dialog reading You have an active workout — Freeform workout, started 5:31 AM. Finish it before starting a new one, or continue where you left off, with Continue Freeform workout and Finish Freeform workout and Start New buttons

Build today's workout#

For a session you didn't plan, tap Build today's workout on the Train tab. Choose how many minutes you have, optionally pick the muscles you want to focus on, and check the equipment and any injuries to avoid (Datum remembers these for next time). Datum then proposes a session to review before you start.

  • By default it aims at the muscles furthest below the set range over the last 7 days (see Muscle balance), the least trained first. If you haven't logged anything yet, or nothing in the last 7 days, or every muscle is already in range, it says so and gives you a balanced full-body mix instead.
  • It uses the same exercise choices as the plan builder: your equipment, injury exclusions, and a bias toward compound exercises when time is short. The length is an estimate. It also leans on you: exercises you have logged before are favored, strongman and Olympic lifts and band or chain variants are held back unless you already use them, and when two exercises are equally good it prefers common equipment. Its equipment choice is combined with Equipment I have in Settings, so it uses only equipment both allow.
  • Don't like a pick? Each exercise on the review screen has a replace icon beside it. It suggests exercises for the same muscle, the same kind of movement first, then your favorites and the ones you have logged, limited to your equipment (with a switch to show any equipment) and leaving out what is already in the session. Sets and rest carry over; the reps reset only when you swap between a reps exercise and a timed hold.
  • It starts a normal freeform workout, so Resume, Finish now and Discard work as usual. It isn't part of any plan or training block and never changes a plan or template. To keep it, use Save as template when you finish, as with any freeform workout.
  • If you already have a workout in progress, Datum asks whether to continue it or finish it first.

Resuming a workout#

Whenever a workout is in progress, the header tints violet — with the tab's own title inside it — and a matching banner shows just above the tab bar, with the session's name and start time, no matter which tab you're on:

The Train tab with a violet-tinted header reading Plans and a matching banner above the tab bar reading Freeform workout, Started 9:08 PM, with a Resume link

Tap either the header or the banner to jump straight back into logging, exactly where you left off, including anything you'd typed into a not-yet-logged set, a set's running timer, and any rest countdown, all picking back up rather than resetting. Datum never jumps you into this screen automatically — relaunching the app always opens to whichever tab you left it on, with the tinted header and banner waiting there. From the logging screen itself, tap the chevron in the top-left corner to minimize back to browsing without finishing — the header and banner stay put as your way back in.

Changed your mind about a workout entirely? Tap Discard in the top-right corner — Datum asks you to confirm before deleting it, since this is reachable mid-workout. See Deleting a workout for what happens next.

An in-progress workout also shows up in History with an In progress badge. Open it to Resume it from there too, or to Finish or Discard it — see History for details.

The logging screen#

Every planned set — warm-ups, working sets, and drop sets — is laid out as its own row up front, in the order you'll do them, rather than one shared input you log over and over:

The active workout screen for an exercise, showing a W1 warm-up row, Set 1/2/3 rows marked Not started, a D1 drop set row, weight/reps/RPE fields, a Start Set button, and links for adding a warm-up, set, drop set, or opening the plate calculator

Here, W1 is a warm-up set, Set 1–3 are working sets, and D1 is a drop set — all labeled and ordered exactly as the template defined them (see Plans & Templates). If this is a freeform workout, or you want to add something the template didn't plan for, the + Warm-up, + Set, and + Drop set links let you add rows on the fly. Added a row by mistake? A minus button appears next to the same link as long as that row is still unlogged, letting you take it right back.

With more than one exercise in the session, "Exercise 1 of 2" (etc.) at the top lets you page between them with the arrows on either side. A small dot per exercise underneath fills in solid once that exercise's sets are all logged, half-filled while it's in progress, so you can see progress across the whole session without opening each one. Tap the label or any dot to open the full exercise list for the session, with every exercise's status (done, in progress, or pending) and the current one marked. Tap any exercise in that list to jump straight to it; this only changes which one you're viewing, it doesn't reorder the workout.

Took an exercise out by mistake, or added one you didn't mean to? While the workout is in progress, open the + menu and choose Remove (it names the exercise on screen), or open the full exercise list and swipe an exercise left to Remove it. If nothing was logged on it, it goes straight away. If you've already logged sets on it, Datum asks first, because those sets are deleted with it, and Cancel keeps it. A class or cardio activity added by mistake has a ... button beside its row with Remove activity. The rest of the workout keeps its order, and a superset that would be left with one exercise simply becomes a normal exercise.

Minimizing mid-workout and resuming later brings you back to whichever exercise you were last viewing, not back to the first one.

Tap the exercise's name or photo at the top of the screen to open its full detail — instructions, muscle groups, and your notes — without leaving the workout. Tap back (or Done) and you land right back where you were logging.

Last time and try more#

Under an exercise's name, Datum shows what you did the last time you did it, for example Last time (Oct 2): 135 lb x 8, 8, 7 · 3 sets. Sets at the same weight share one weight, warm-ups are left out, and drop sets are named separately. Nothing shows if you haven't done the exercise before.

"Last time" means the last workout where you actually logged that exercise, in any template or none. If the same exercise sits in two templates, doing it in one counts as last time for the other. A workout where the exercise was planned but you skipped it is passed over, so it never hides your last real numbers. The weight and reps that start in the boxes for a new set come from the same workout.

With Progressive overload suggestions on in Settings, a second line says when to go up: if every working set last time reached this workout's target reps, it suggests the heaviest weight you used plus a small step ("Try 140 lb today. Every set last time reached 8 reps."). The step follows the plan's training goal, or your default goal in Settings for a freeform workout. For a hold it suggests 5 seconds more than your shortest hold. It changes nothing for you, and there is no suggestion for bodyweight sets, AMRAP sets or 5/3/1 lifts. This works from your last workout only. The suggestion on a template's exercise screen (see Plans & Templates) is separate and waits for a streak of workouts, so the two can differ.

Add weight next time. Near the bottom of each exercise is a tick, Add weight next time (Add time next time for a hold). Tick it when a set felt easy. The next time you open that exercise, a line says "Reminder from last time: add weight today." The reminder goes away when you finish that exercise, or when you tick or untick the box. It is kept on this phone only, so it does not sync between devices or appear in an export.

Logging one set#

For each set, in order:

  1. Enter your reps, and your weight if the exercise uses one (leave weight blank for a bodyweight exercise and it logs as 0). Your prior workout's numbers for this exercise are shown as a reference goal, if you've done it before). The active set's row gets a light violet highlight so it's obvious which one you're working on. Warm-up sets can be filled in for you — see Suggested warm-up weights.
  2. Tap Start Set when you begin the set. This starts a timer that tracks how long the set actually takes, shown live next to the "Set" label while it runs and afterward (e.g. "12s") next to the completed row. Starting a set also skips any rest countdown still running from the set before it — no need to tap Skip separately once you're already moving. A Cancel button appears next to it while the set is running, in case you started it by mistake or changed your mind — tapping it clears the timer without logging anything.
  3. Optionally enter an RPE — how hard the set felt, from 1 to 10 in half-point steps. This is entirely optional and can be left blank; see RPE if you're not familiar with it.
  4. Tap End Set (the same button, now relabeled) when you finish the set. A completed row gets a checkmark and a subtly different background so it reads as done at a glance. Whatever you've typed into a not-yet-logged set's fields — a real prior-workout prefill or just something you're part-way through typing — stays put even if you switch to another exercise and back.

Made a mistake on a set you already logged? Tap its completed row to fix the weight, reps or RPE, or delete it entirely — this works for as long as the workout is still in progress, from this screen or from History. Once you finish the workout, its sets become a permanent record and can no longer be edited or deleted.

If a paired Bluetooth heart rate monitor is connected (see Settings), your live heart rate shows just under the exercise name while you log, the same as it does during a class or cardio activity.

For a time-based exercise — a plank, a carry, a wall sit, or any other hold — the reps field is replaced by a live Start Hold / Stop timer instead: tapping Start Hold begins a live count-up (shown as minutes:seconds), and tapping Stop ends it and logs however long you held it. Datum also shows Last: and your prior session's hold time right next to the counter, the same reference-goal idea as the weight/reps prefill for a rep-based set. Weight is entirely optional for a hold — leave it blank for a bodyweight exercise, or enter it for a weighted plank or carry. The same is true for a rep-based bodyweight exercise (a push-up, a pull-up, and the like) — leave weight blank there too and it logs as bodyweight, same as a hold.

Exercises done one side at a time work the same way, whether they are holds or counted reps: Side Plank, Oblique Crunches, a one-arm row, a single-leg press, a side bend. One set means both sides, not just one, so a plan of 3 sets means 3 sets on each side, and its target reads "3 x 10 each side". For a rep-based one, enter the reps for the first side and tap End Set. Nothing is logged yet. The row switches to Side 2 of 2, the button reads Start Set (Side 2), and the reps box keeps the first side's number as a suggestion. Rest starts only after the second side. The logged row shows both sides (for example "20 lb x 12 · 10"), and history and "last time" show them as 12/10. Volume counts both sides, a record uses your better side, and progressive overload only moves up once both sides reach the target.

For a hold, one set means holding both sides, not just one. For these, the row shows "Side 1 of 2" first; tapping Stop after the first side doesn't log anything yet, it just stashes that side's time and immediately re-arms the button as Start Hold (Side 2). Only stopping the second side actually logs the set, and the completed row shows both times together (e.g. "0:32 · 0:28"). Changed your mind partway through? Cancel backs out of the whole set, both sides, not just whichever one is currently running.

Once every planned (and any manually-added extra) set for an exercise is logged, its name gets a checkmark badge at the top of the screen, and its dot in the exercise-pager strip (see above) fills in solid — an easy way to tell which exercises in a multi-exercise workout are actually done.

Target RPE and suggested weights#

When an exercise has a target RPE, the logging screen shows "Target RPE 8" above the set's boxes with a suggested weight, already filled into the weight box. The suggestion is an estimate worked out from your last session's best set and a published RPE chart, and Datum says so on screen. Enter an RPE for each working set you log: the next set's suggestion moves toward the target. Warm-up sets and drop sets never feed the estimate. Type over the weight whenever you like. If the plan has a training block, the target shown already includes that week's change, and the week is shown at the top of the screen.

Personal record markers#

When a set you log beats everything you've done before in that exercise, its row gets a violet PR tag and a short line underneath naming the record. Datum checks five records, each against your earlier workouts:

  • Heaviest weight: more weight than any earlier set.
  • Est. 1RM: a higher estimated 1RM than any earlier set, which a lighter set with more reps can earn without being your heaviest.
  • Most reps at this weight: more reps than you've ever done at exactly that weight.
  • Session volume: more total weight × reps for this exercise in one workout than in any earlier workout. The tag lands on the set that first passes your previous best, not on every set after it.
  • Longest hold: for a time-based exercise, a longer hold than any earlier one.

A few rules worth knowing:

  • A tie is not a record. You have to beat the earlier best.
  • Warm-up sets never count. Drop sets do.
  • The first time you log an exercise, or the first time you use a given weight, shows nothing, because there is nothing earlier to beat.
  • If you beat your own record twice in one workout, both sets are marked.
  • A set with no weight (a bodyweight set) can only earn the most-reps record.
  • If you edit or delete a set in this workout, the tags update when you close the edit screen.

Datum works this out from the sets you've logged. Nothing extra is stored, and there is no sound or vibration. The same tags show in History.

Suggested warm-up weights#

If an exercise has warm-up sets and you've never logged a warm-up for it before, Datum fills the weights in with a suggested ramp instead of leaving them blank. It's a starting point, not a prescription — type over it whenever you like.

The ramp builds toward roughly 70% of your working weight, spread across however many warm-up sets you've set up:

Warm-up sets Suggested For a 225 lb working weight
1 50% 115
2 45%, 65% 100, 145
3 35%, 50%, 70% 80, 115, 160
4 30%, 45%, 55%, 70% 70, 100, 125, 160

Weights are rounded to something you can actually load — the nearest 5 lb, or 2.5 kg if you work in kilograms.

The working weight it ramps toward is your exercise's target weight if you've set one, and otherwise the first working set you logged last time.

Two things it deliberately won't do:

  • It never overrides what you actually lifted. If you warmed up for this exercise in a previous session, Datum fills your warm-ups in from that session and suggests nothing — your own numbers are better information than a percentage.
  • It doesn't apply to timed exercises. A plank or a dead hang has no weight to ramp.

If Datum has nothing to work from — a brand-new exercise with no target weight and no history — the fields stay blank, as before.

The rest timer#

As soon as you end a set, a rest countdown starts automatically at the top of the screen:

A purple rest timer banner reading Rest: 0:40 with a Skip button, above a completed W1 warm-up set and the next set ready to log

The countdown length comes from the rest time set on the template (or a default, in a freeform workout). To change it for the exercise on screen, use the Rest stepper under the sets (15 seconds a step, up to 10 minutes); exercises with warm-up or drop sets also get a Warm-up rest or Drop set rest stepper. The new length applies from the next set you log, so a rest already running keeps its length (tap Skip to end it). It changes this workout only, never your template, though a template you save from the workout afterwards uses it. Tap Skip any time to end the rest early and move on immediately — useful if you recover faster than planned, or just don't want to wait.

The timer keeps counting down no matter which exercise you're currently viewing — jump ahead to another exercise mid-rest and the banner follows you, so you never lose your place. When the countdown reaches zero, Datum plays a short tone (pick which one in Settings) and a haptic tap; by default the tone respects your phone's Ring/Silent switch (it goes quiet, but the haptic still fires) and still plays through connected headphones. To hear it even with the switch on silent, turn on Play timer sound when silent in Settings. The tone then plays on top of any music or podcast without pausing it.

With the screen locked, or while you're in another app, Datum shows the rest countdown on your lock screen and in the Dynamic Island (a Live Activity), and sends a notification when the rest is over, using the tone you picked. The first time, iOS asks whether Datum may show Live Activities, and may ask again later whether to keep allowing them; you can turn them off in iOS Settings under Datum. When the rest ends the countdown stays on 0:00 until you open Datum or swipe it away. The first time a rest starts, iOS asks whether Datum may send notifications; if you decline, everything else still works. A notification's own sound always follows your phone's Ring/Silent switch, so with Play timer sound when silent off, a locked phone on silent gets the banner and, if Vibrate on Silent is on in iOS Settings, a vibration, but no sound. With it on, Datum keeps itself running in the background during a rest and plays the tone itself when the rest ends, even with the screen locked and the switch on silent, on top of any music. The notification is then sent without a sound so you don't hear it twice. If iOS stops Datum, or you force-quit it, you still get the banner but no tone. Skipping the rest, finishing the workout or discarding it cancels the notification.

No rest timer starts once there's nothing left to rest for — that is, once the set you just finished was the very last one in the entire workout. Finishing all the sets in just one exercise with others still to go still rests as usual, since that rest is for the exercise you're about to move to next.

The lock screen and Dynamic Island#

While a workout is in progress Datum shows one Live Activity on the lock screen and in the Dynamic Island: the time the workout has been running, the exercise you're on, which set it is, and how many sets of the whole workout are done. During a rest it switches to the rest countdown, then goes back to the workout view when the rest ends, even with the phone locked. It disappears when you finish or discard the workout. If you turn Live Activities off for Datum in iOS Settings, you simply don't get it. The rest-over tone and notification are separate and work as before.

Supersets during logging#

If two or more exercises were marked as a superset when the template was built (see Plans & Templates), Datum automatically walks you through one set of each exercise in the group in turn, with no rest in between, resting only after you finish a full round. The screen shows "Superset 1 of 2" (etc.) so you always know where you are in the rotation.

Adding an exercise mid-workout#

Tap + in the top-right corner and choose Add exercise to add one to the session on the fly, whether you started from a template or freeform. It's added after whatever you've already got, and the pager updates to include it.

If this session started from a template, Datum quietly keeps track of anything you do that the template didn't plan for: a new exercise like this, or extra sets/warm-ups/drop-sets logged beyond what an existing exercise's plan called for. When you finish the workout, a Save to template section lists everything it noticed, checked by default; uncheck anything you don't want carried forward. Confirming writes those changes into the template itself, so your next workout from it already includes them. Nothing is ever removed from the template this way, only added.

The recap#

When you finish a workout and tap Done, Datum shows a recap before you go back to the app. It reads what you did and adds nothing you have to do: tap Done again to leave it.

  • Workout complete, with the workout's name, the date and how long it took.
  • Total volume, then the number of exercises, sets and reps. Volume is weight times reps over your working sets. Warm-ups are left out, drop sets are in, and holds and carries have no volume. This is the same volume as the session volume record, so it can differ from the volume chart in Reports, which counts warm-ups.
  • An activity, such as a ride or a class, gets its own block. A tracked outdoor activity shows its route on a map with distance, time and pace; any other activity shows its time. A workout that was only an activity shows just that block, with no empty exercise counts.
  • Nice work, a few plain facts, shown only when they are true: most volume yet for this template (not for a freeform workout), the second or later workout this week (weeks run Monday to Sunday), a streak of two or more weeks in a row with a workout, and a new fastest time on a saved route.
  • Personal records you set in this workout, each with the record, your new number and your previous best. They are the same ones the Finish screen lists. See Personal record markers.
  • Calories, when Datum has a measured figure.

There is no animation or sound. The recap appears after Finish Workout and Done. Finishing an old workout from History with Finish now, or finishing the old one from the "you have an active workout" prompt so you can start a new one, takes you straight on without a recap.

Classes & cardio activities#

Besides exercises, a workout can include a duration-based activity — a gym class or cardio-machine session, logged with a live start/stop timer or after the fact instead of sets and reps. See Classes & Cardio Activities for the full guide, including live heart rate during an activity.

Exercise notes#

Each exercise has a persistent notes field — the collapsible Notes banner near the top of the screen, collapsed by default. Tap it to expand, read, or write notes for that exercise: form cues, reminders about machine settings, anything you want in front of you next time you do that exercise. These notes carry over between workouts automatically.

Plate calculator#

Tap Plate calculator on the logging screen to see the per-side plate breakdown for a target barbell weight:

The plate calculator showing a target weight of 225, bar weight of 45, and a load per side of 45 plus 45

Enter your target weight and the bar weight you're using (defaults to a standard 45 lb/20 kg bar), and Datum works out how much weight to load on each side using standard plates — in the example above, 225 lb total needs a 45 lb bar plus two 45 lb plates per side (45 + 45 + 45 + 45 + 45 = 225). If your target isn't exactly reachable with standard plates, Datum tells you the closest weight you can load instead of silently rounding.

Finishing a workout#

Tap Finish Workout in the top-right corner when you're done. You'll get one more chance to add end-of-workout notes — reminders for next time, anything worth remembering about the session as a whole (as opposed to per-exercise notes, above) — and, for a template-based session that went beyond the plan, a Save to template review (see Adding an exercise mid-workout):

The Finish workout screen with a notes field for reminders about the session

For a freeform workout, this screen also offers Save as template: pick an existing Plan to file it under (or create a new one) and name it, and Datum builds the template's exercises, set counts, and target weight/reps from what you actually logged, using your last set of each exercise as the starting target. Once created it's an ordinary template, exactly as if you'd built it by hand. See Plans & Templates.

If you set any personal records, the Finish screen lists them under Personal records: one line per exercise and record, with the new value and your previous best, such as "Heaviest weight: 235 lb (was 225 lb)". If you beat a record more than once in the workout, only the final best is listed, and for most reps at a weight only the heaviest weight for each exercise. The section doesn't appear when there are no records.

Tap Done to save the workout. It immediately appears in History with full set-by-set detail, and feeds into Reports.

If Apple Health is connected, the finished workout is written there too, and Datum will show a calorie estimate and average heart rate for that session's time window (see Apple Health Integration).