Switching from Hevy or Strong to FormLens: Import Your Workout History

Both apps can export your workout history as a CSV file — a plain spreadsheet with one row per set. Export it on your iPhone and save it to the Files app (iCloud Drive or On My iPhone).

• From Strong: open Strong's settings and choose Export Strong Data, as Strong's help centre (opens in a new tab) describes.
• From Hevy: use the data export in Hevy's settings to export your workouts as a CSV file.

Menus change between app versions, so if you can't find the option, search that app's help pages for “export”. Keep the original file until you've checked the import. Then open it in Files or a spreadsheet app and look at its first row, the column names. FormLens reads two layouts:

• Hevy, in kilograms: columns such as exercise_title, set_type and weight_kg. A Hevy account set to pounds — and some older exports — writes weight_lbs and distance_miles instead, and FormLens doesn't read that file.
• Strong, separated by commas: names without units — Date, Workout Name, Duration, Exercise Name, Set Order, Weight, Reps. Some Strong exports use semicolons, which FormLens doesn't recognise, or put the unit in the name, such as Weight (kg), which it doesn't read as a weight.

1. 1Open FormLens, go to the Profile tab and tap the settings icon in the top-right corner.
2. 2Under Your Data, tap Import Workouts (Hevy/Strong CSV) and pick the file.
3. 3FormLens reads the file and tells you how many workouts it found. Workouts at the same time as one already in your log are skipped.
4. 4From Hevy, tap Import. From Strong, tap Import — weights in kg or Import — weights in lbs, whichever unit your Strong app shows.
5. 5A last message tells you how many workouts came in.

If a file lives in iCloud and hasn't finished downloading, FormLens says so — try again in a moment. A file in any other layout isn't recognised, and the message asks for a Hevy or Strong export; if yours came from one of them, compare its first row with Step 1.

Sets keep their type. Hevy's file names it; Strong's marks a non-working set with a letter in the Set Order column — W for a warm-up, F for failure, D for a drop set — and numbered sets come in as working sets. Every imported set is marked as completed, and a workout without a title gets one from its exercises.

Each exercise name in the file goes through three checks, in order:

1. 1The four barbell lifts. Names like Squat (Barbell), Back Squat, Bench Press (Barbell), Flat Bench Press, Deadlift (Barbell), Conventional Deadlift, Overhead Press (Barbell), Shoulder Press and Military Press become FormLens's own Squat, Bench Press, Deadlift and Overhead Press — so imported sets continue the same history as the ones you log in the app.
2. 2An exact library match. A name that matches an exercise in FormLens's library, ignoring capitals and extra spaces, becomes that exercise.
3. 3Everything else comes in under the name in your file, as your own exercise.

Matching is strict on purpose, so an import never merges two different exercises: dumbbell, Smith-machine and machine versions stay separate from the barbell lift, because their one-rep maxes differ, and so do Front Squat, Romanian Deadlift and other variations. The trade-off: a lift your old app spelled unusually arrives as a separate exercise under that spelling.

FormLens skips every imported workout that overlaps one already in your log. Import the same file twice and the second time adds nothing; import a fresh export a few weeks later and only the new workouts come across — handy if you log in both apps for a while. If you logged a session in both apps, the FormLens one stays.

One exception: if Apple Health has already given FormLens an empty workout at that time — a strength session with no sets, say — the imported workout replaces it. After an import, FormLens recalculates your personal records from your whole history, imports included.

1. 1In Settings → Your Data, tap Export Workouts (CSV).
2. 2Save FormLens-workouts.csv to Files, AirDrop it, or send it wherever you keep backups.

The file holds every workout in your log, one row per set, in Hevy's kilogram layout: weights in kilograms, distances in kilometres, set types as normal, warmup, dropset or failure. The four barbell lifts and running keep their English names whatever language the app is in, and a workout with no sets, such as one from Apple Health, is a single row. FormLens can read its own export back, and any spreadsheet app can open it.

It's your training log, not your analyses: form scores aren't in the file, and your workout videos never leave your phone (privacy policy).

• Files in another layout. A Hevy file in pounds or a Strong file separated by semicolons doesn't import at all, so check its first row before you import (Step 1).
• Anything that isn't a workout. FormLens reads the workout rows only — not routines, templates, body measurements, progress photos or settings from your old app.
• Form scores. Imported sets have no video, and only sets you film get a form score (what the score means). Film a set to get your first — here's how.
• A repeated exercise within one workout. If an exercise appears twice in the same workout — bench, rows, then bench again — its sets are merged into one exercise, and the first note for it is the one kept.
• Supersets from Strong. Strong's file doesn't include them; Hevy's does.
• Rows with nothing to log. A row with no weight, reps, distance or time — Strong's rest-timer and note rows, say — is skipped, as is a row whose date FormLens can't read. If a file yields no workouts, the message says how many rows were skipped.

• Workout CSV exported from your old app and saved to Files
• Its first row matches one of the two layouts in Step 1
• From Strong: you know whether the app shows kg or lbs
• Profile → settings → Your Data → Import Workouts
• The number of workouts found looks right before you confirm
• A few squat, bench and deadlift sessions spot-checked afterwards
• The original file kept until you're happy with the result