Settings
Settings is grouped into a few labeled sections, roughly most-touched first and support/about last.
Appearance & Units#
- Appearance — System (default), Light, or Dark. Overrides your device's own Light/Dark setting for Datum specifically, taking effect immediately, no restart needed. Choose System to just follow whatever your device is set to.
- Weight unit — pounds (lb) or kilograms (kg). Changing this reformats every weight shown in the app, including past workouts — nothing is recalculated incorrectly, it's purely a display conversion.
- Length unit — inches (in) or centimeters (cm), used for body measurements.
Training#
-
Progressive overload suggestions — off by default. When on, suggests a weight or rep increase on a template exercise once you've consistently hit its current target — never forced, you choose whether to apply it. The training goal that shapes those suggestions belongs to each Plan and is set on the plan's own screen, so a strength plan and a conditioning plan can progress differently. The picker here only sets the default goal for new plans you create from now on; changing it never alters a plan you already have. See Plans & Templates. With it on, an exercise in a workout also shows a short "try more today" line when every set last time reached its target; see Logging a Workout.
-
Rest timer sound — which tone plays when the rest timer reaches zero. Tap through to choose from iOS's own built-in alert tones, grouped Current and Classic the same way Settings > Sounds & Haptics does — tapping a tone plays it right away so you can hear it before deciding. A haptic tap always fires too; by default the tone is silenced by your phone's Ring/Silent switch and still plays through connected headphones. See Logging a Workout.
-
Play timer sound when silent (off by default). Turn it on to hear the rest timer's tone even when your phone's Ring/Silent switch is on silent. It plays on top of any music or podcast rather than pausing it, and the haptic tap still fires either way. It sounds with the screen on and with the screen locked or Datum in the background. During a rest Datum then keeps itself running in the background so it can play the tone, and the rest-over notification is sent without its own sound so you don't hear it twice.
-
Equipment I have. Which equipment you can use: Anything, Full gym, Home gym (dumbbells, barbell, bands, kettlebells, an EZ bar and bodyweight), Bodyweight only, or any mix you tick yourself. Exercise suggestions, the replace option, "Add an exercise to a template" and "Build today's workout" leave out anything that needs equipment you don't have; with nothing ticked they can use anything. An exercise with no equipment listed is always allowed. "Build today's workout" also has its own equipment choice, and uses only what both allow.
-
Focus areas. The parts of your body you want to build up: regions (chest, back, shoulders, arms, core, legs, glutes) and single muscles. In the muscle balance report a focus area gets a weekly target a quarter higher, is listed first and is outlined on the body figure, and in Balanced workout with goals it is expected to take a larger share of your sets. Balanced workout ignores it. Clear focus areas removes them all.
-
Ease off. The opposite of a focus area, for a part of your body you want to hold steady or work around, such as an injury or a sport that already trains it. In the muscle balance report an eased area gets a weekly target a fifth lower, is marked Eased off, and is never called light, and Build today's workout does not pick it on its own. In Balanced workout it has no effect. Choosing an area as a focus removes it from Ease off, and the other way round.
-
Weekly sets guideline. The sets per muscle each week that count as in range, 10 to 20 by default, used by the Goals view of the muscle balance report and by "Build today's workout". Set the minimum and maximum with the steppers; a Reset button appears once you change them. 10 to 20 is a common guideline, not a rule.
Security#
- App Lock — off by default. When on, requires Face ID, Touch ID, or your device passcode to open Datum, with a "Re-lock after" timer (Immediately, 1/5/15/30 minutes, or 1 hour) you choose. See the note below.
Health & Sync#
- Apple Health — a toggle for Datum's two-way Apple Health integration: completed workouts and body metrics are written out, and calorie/heart-rate data, smart-scale body metrics, and dietary data from other apps are imported in. Turning it on includes a one-time catch-up sync of workouts you'd already logged before connecting; turning it off any time stops syncing. Off by default. See Apple Health Integration for exactly what syncs.
- Sync with iCloud — backs up and syncs your workouts across your own devices via iCloud. Off by default. Turning it on uploads everything already on this device automatically the first time; turning it on or off takes effect the next time you restart Datum, which the screen will remind you to do. Once it's on, the screen tells you what sync is actually doing. See the note below.
- Delete iCloud copy — removes the copy of your data stored in iCloud. Everything on this iPhone stays as it is. Always available, whether or not sync is on. See the note below.
Heart Rate Monitor (Experimental)#
Pair a standard Bluetooth heart rate strap or watch and Datum shows its live reading during a workout or activity. Marked experimental until it has been checked against real monitors. How it works in practice is in Classes & Cardio Activities.
- Pair a Heart Rate Monitor. Scans for monitors nearby and lists what it finds. Tap the one that is yours. Datum never connects to the first monitor it sees, so a stranger's strap in the gym is not a risk.
- Paired monitor and Forget This Monitor. Once paired, the monitor's name shows here. Forget disconnects it and removes it; nothing reconnects afterwards.
- Connect has three choices:
- Manual: connect and disconnect yourself with the buttons here.
- When I start a workout (the default): Datum connects when a workout or activity starts or is resumed, and disconnects when the last one is finished or discarded, so the monitor's battery is not used between workouts.
- Whenever Datum is running: Datum stays connected and reconnects whenever the monitor comes back into range. This uses more of the monitor's battery.
- Last disconnected shows when the monitor last dropped and why (for example "Connection timed out (usually out of range)" or "Bluetooth was turned off"), so a monitor that keeps dropping can be diagnosed.
The paired monitor and these settings live on this phone only. They are not backed up, synced through iCloud, included in the data export or sent in a shared plan.
Data#
- Body metrics — opens the screen for logging weight, body fat %, lean body mass, and other measurements. See Body Metrics & Measurements.
- Export data — shares your plans, workout sessions, body metrics, and nutrition data as a JSON file via the standard iOS share sheet. See Exporting & Importing Your Data.
- Import data — adds plans, workout sessions, body metrics, and nutrition data back in from a previously exported JSON file. Never removes or overwrites anything already in the app. See Exporting & Importing Your Data.
- Import shared plan/template — opens a file picker for a
.datumfile someone shared with you, and shows a preview of what's in it before anything is added — the same preview you get by tapping a.datumfile directly in Mail, Messages, or Files; this is the fallback for a file you saved earlier or received somewhere that doesn't hand off to Datum automatically. See Sharing Plans & Templates.
Exercise library updates#
- Check for updates automatically — on by default. When on, Datum looks for a newer exercise list at most once a day, when you open the app.
- Check now — checks right away, whether or not the automatic check is on.
- Installed version and Last checked — which version of the exercise list you have, and when Datum last reached the exercise site.
See Exercise Library.
Support#
- Report a bug / Request a feature — opens an email to Datum's developer, pre-filled with prompts for the useful details and with your app and iPhone version at the bottom. No workout data is included, nothing is sent until you tap Send, and you can edit or delete any of it first. See the note below.
About#
- Datum website / Documentation — opens the Datum website or its documentation section in your browser. The same guides you're reading now, kept up to date there.
- Acknowledgements: credits and licenses for work Datum uses. The body figure's muscle shapes come from the open-source MuscleMap project (MIT license), reproduced here in full.
- Version — the app version you're running.
A note on App Lock#
App Lock uses your device's own Face ID/Touch ID/passcode — Datum never sees or stores a separate PIN. Turning it on needs a passcode already set on your device; if none is set, the toggle is disabled with an explanation. Once on, Datum locks on a fresh launch, after the chosen timeout elapses while backgrounded, and any time your device's screen was locked while Datum was in the background — whichever comes first. It also blurs Datum's content in the App Switcher, so your workout data isn't visible in the multitasking preview.
A note on iCloud sync#
iCloud sync is new in this Beta build and is off by default. Turning it on requires an iCloud account signed in on your device. Because the underlying sync connection is only established at launch, changing the toggle needs a restart of Datum to actually take effect, which the screen will remind you to do.
What the status line tells you#
When sync is on, Datum shows you what it's actually doing, rather than leaving you to guess:
- Syncing with iCloud. — confirmed working.
- Checking iCloud… — Datum hasn't heard back yet. Normal for a moment after launch.
- Not signed in to iCloud, No iCloud connection right now, or iCloud is restricted on this iPhone — sync can't run at the moment, but nothing is broken. Sign in, reconnect, or wait, and Datum picks up where it left off on its own.
- iCloud sync isn't working. — something genuinely went wrong. Datum shows the underlying error so it can be reported rather than guessed at. Your data on this iPhone is unaffected.
Datum never turns the setting off for you. If you asked for sync and something temporary is in the way — you're signed out, or offline — your choice stays as you set it and syncing resumes by itself. Earlier Beta builds silently switched the toggle back off in that situation, which made it look like the setting hadn't stuck.
What syncs, and how conflicts are handled#
Sync covers everything Datum stores: plans, templates, your exercise library, workout history, body metrics, and nutrition entries. If the same thing is edited on two devices before they've had a chance to talk to each other, the most recent change to each individual field wins, and that happens silently — Datum won't ask you to pick a version.
If anything looks like it isn't syncing the way you'd expect, Export data remains a reliable manual way to move a copy of your data between devices.
Deleting the iCloud copy#
Turning sync off just stops syncing — the copy already in iCloud stays there. That's deliberate: the toggle means "sync or don't sync," and it is never destructive on its own. When you turn it off, Datum asks whether you also want the iCloud copy deleted, and the answer defaults to no.
There's also a Delete iCloud copy button, available at any time.
What you should know before using it:
- It cannot be undone.
- It removes the copy for your whole Apple Account, not just this iPhone. iCloud stores one shared copy, so deleting it affects every device signed in to that account. (Datum is iPhone-only today, so in practice that means this iPhone — but if you ever add a second device with sync on, it would upload a fresh copy.)
- Everything on this iPhone stays exactly as it is. Your plans, workouts, body metrics and nutrition entries are untouched.
- It turns iCloud sync off. If sync stayed on, Datum would upload a fresh copy within seconds and the deletion would be pointless.
- Datum needs to be closed and reopened to finish. The deletion happens on the next launch, while nothing is syncing. This isn't a formality — removing the iCloud copy while syncing is active can take your on-device data with it.
Afterwards Datum tells you what actually happened: that the copy was deleted, that there was nothing stored in iCloud to begin with, or that it couldn't be removed and is still there — including the underlying error. It will never claim your data is gone when it isn't.
Turning sync back on later simply uploads a fresh copy from this iPhone.
If you delete Datum's data from iOS Settings#
iOS has its own way to remove an app's iCloud data, under Settings > your name > iCloud > Manage Account Storage > Datum. That path isn't controlled by Datum, and if Datum is open and syncing when you use it, it can remove the data from this iPhone as well. Use Datum's own Delete iCloud copy button instead — it sequences the deletion safely. If you do use the iOS Settings path, quit Datum first, and keep an exported backup.
A note on sending feedback#
Report a bug and Request a feature each open a normal email, addressed to Datum's developer and pre-filled with a few questions worth answering — what happened and what you expected, or what you're trying to accomplish.
At the bottom, Datum adds three lines: the app version, your iOS version, and your device model. That's all. No workout data, nothing that identifies you, and it's written into the body in plain sight rather than hidden, so you can read it and delete it before sending if you'd rather not include it.
Datum never sends anything on its own. The email is composed in your own mail account, and nothing leaves your iPhone unless you tap Send.
If your iPhone has no email account set up, Datum says so and shows you the address instead, so you can write from somewhere else.