Get the app (opens the App Store in a new tab)

Help

Import a routine template (.liftloggr.json) into LiftLoggr

Open a .liftloggr.json file and tap Import, or paste template JSON in Settings → My data → Import workout templates. Format, fields and fixes.

Key takeaways

  1. 01Fastest: open a .liftloggr.json file and tap Import.
  2. 02Or: Settings → My data → Import workout templates → Paste or Open JSON file → Validate & preview → Import templates.
  3. 03Share any routine with the share button on its card in Routines.
  4. 04Importing adds routines; it never changes your history.
On this page

Open the .liftloggr.json file on your iPhone, pick LiftLoggr, and tap Import. The routine lands in the Routines tab, ready to start. You can also paste template JSON in Settings → My data → Import workout templates.

Checked against LiftLoggr 1.5.2 for iPhone.

Import a file

  1. Download or receive the file (Safari, Mail, Messages, AirDrop, Files).
  2. Tap it, then Share, and pick LiftLoggr. If LiftLoggr opens it directly, skip ahead.
  3. Import into LiftLoggr? shows “Workout template”, the file name and a count, for example “4 templates · 22 exercises · 70 sets”. Nothing is imported until you confirm.
  4. Tap Import. The notice reads “Imported 4 template(s); kept 0 existing template(s).”
  5. Open the Routines tab. Imported routines with a weekday appear on Home on that day.

The program pages on this site each offer a .liftloggr.json download of the plan.

Paste or open in Settings

  1. Go to Settings → My data → Import workout templates. The screen is titled Import templates.
  2. Under Template JSON, tap Paste (copies from the clipboard) or Open JSON file.
  3. Tap Validate & preview. Errors show in plain words, for example “Every exercise needs a name.”
  4. Under Preview, check the counts and tap Import templates.
  5. The result reads, for example, “2 templates imported, 1 already present”.

Share a routine

In the Routines tab, tap the share button (square with an arrow) on a routine’s card. LiftLoggr makes a file named like LiftLoggr-Push-Day.liftloggr.json that anyone with LiftLoggr can import. It holds the plan only, never your workout history.

The format

Version 1 of the routine-template format, in short:

{
  "formatVersion": 1,
  "routines": [{
    "name": "Push Day",
    "weekday": 2,
    "focusLine": "Chest / shoulders / triceps",
    "warmup": [{ "name": "Band pull-aparts", "detail": "2 x 15" }],
    "exercises": [{
      "name": "Barbell Bench Press",
      "schemeLabel": "4 x 6-8",
      "autoWarmup": true,
      "sets": [
        { "weight": 60, "reps": 8 },
        { "weight": 60, "reps": 8 },
        { "weight": 50, "reps": 10, "kind": "drop" }
      ]
    }]
  }]
}
Field Rule
formatVersion 1
weekday Optional. 1 = Sunday … 7 = Saturday
weight Kilograms, or null for bodyweight
isWarmup true for a ramp-up set
kind “drop” for a drop set, right after its working set
rir Planned reps in reserve, 0–4
supersetGroup Same letter on adjacent exercises makes a superset
autoWarmup true lets LiftLoggr build warm-up sets each session
routineID Optional stable ID; re-importing the same ID never duplicates
exerciseID Optional LiftLoggr library ID; otherwise the name is matched

Optional text fields: focusLine, coachNote, tags, schemeLabel, repsLabel, tag, notes, isIntensity.

Write one with a chat assistant

The Import templates screen has Copy prompt for an LLM. It copies a description of this exact format to paste into a chat assistant you already use; paste its answer back with Paste. LiftLoggr itself sends nothing anywhere; the import runs on the iPhone.

Common errors

Message Fix
That isn’t valid LiftLoggr template JSON. Check for a missing comma or bracket
Template format v2 isn’t supported by this app. Update LiftLoggr, or set formatVersion to 1
The file doesn’t contain any routines. Add at least one routine
Every routine needs a name. / Every exercise needs a name. Fill in name
That file isn’t a supported LiftLoggr template or backup. The file isn’t LiftLoggr JSON

A full backup opened the same way is recognised as a backup and merges instead; see export and restore a backup.

Questions

Where do I get .liftloggr.json files?

From another LiftLoggr user (the share button on a routine), from the program pages on this site, which offer a download for each plan, or by writing one in the format below.

What if I import the same file twice?

Nothing is duplicated. A routine with the same routineID, or an identical routine without one, is counted as already present and skipped.

Do exercise names have to match the library?

Matching names (or an exerciseID from the library) link the exercise to its library entry and history. A name that doesn't match still imports under the name you wrote.

0