What is a .FIT workout file, and how do you load one?
What's inside a .FIT workout file, how it differs from an activity file, how to load one onto a Garmin watch or bike computer, and what to do when it won't import.
A .FIT workout file is a structured workout packed into a small file: the steps, their durations and targets, and the repeats, in a form your watch or bike computer can follow. If you've downloaded a session from a coach, a training plan or the Workout Library, this is probably what you got. This guide covers what's inside one, how to load it on common devices, and what to do when it won't import.
FIT in one paragraph
FIT (Flexible and Interoperable Data Transfer) is a compact binary file format from Garmin for fitness data. The same format carries three quite different things, and most confusion comes from mixing them up:
- Activity files: what your watch records: every second of heart rate, pace, power and GPS from a run or ride. This is what you upload to Strava or analyze afterwards.
- Course files: a route to follow, with a line on a map.
- Workout files: a plan to follow, with steps and targets and no map or recording at all.
A workout file is tiny, a few kilobytes at most, because it holds no recorded data, only instructions.
What's inside a workout file
Garmin publishes the FIT specification and a free SDK, so anyone can read or write one. A workout file is a short list of messages:
- File ID: says "this is a workout file", plus who made it and when.
- Sport: running, cycling, pool swimming, and so on.
- Workout: the name you'll see on the watch, and how many steps follow.
- Workout steps, one per step: its duration (time, distance, or until you press lap), its target (pace, heart rate, power, cadence, or none), its intensity (warm-up, active, recovery, cool-down) and an optional note. A repeat is a step of its own that says "go back to step 2 and do this five more times".
Targets can be absolute (4:25–4:35 per kilometer, 230–250 watts) or relative to what the device already knows about you: a heart rate zone, a percentage of max heart rate, or a percentage of FTP. Relative targets travel well. The Workout Library's rides, for example, are written in % of FTP, so the same file sets the right watts on any rider's device, from the FTP in that device's settings.
Looking inside one yourself
Because the format is public, you can read a workout file without a device. Garmin's free FIT SDK includes FitCSV, a small command-line tool that turns a .FIT file into a spreadsheet with one row per message. Open a workout file that way and you'll see exactly the list above: the file ID, the sport, the workout and one row per step. It's often the quickest way to see what a device objected to, such as a step with a target it doesn't support, or a repeat that points at the wrong step.
How to load a workout file
Garmin watches and bike computers
Option 1: Garmin Connect on the web. Import the file into your workouts in Garmin Connect, then send it to your device. It syncs like any workout you built there, and you can still edit it afterwards.
Option 2: USB cable. Connect the device to a computer; it shows up like a drive. Copy the .FIT file into the GARMIN/NewFiles folder, then safely eject and unplug. The device imports new files from that folder, and the workout should appear with your saved workouts (usually under Training). This needs no account and no internet, which makes it handy for one-off sessions.
Option 3: skip the file. If the workout came from Fit File Forge, Send to Garmin puts it on your watch through your Garmin Connect account without a file at all (Send comes with Pro; the .FIT download is the free route).
Other brands
Support for .FIT workout files on other brands varies by device and changes with firmware updates. Some import them directly, some only through their own app, and some use their own formats instead. Check your device's manual before you rely on it.
Indoor training apps
Indoor apps mostly use their own workout formats rather than .FIT workout files, though some can import or export one. Again, check the app's help pages.
When a workout file won't import
Most failures come down to a handful of causes:
- It's not a workout file. An activity or course file in
NewFileswon't turn into a workout. Check where the file came from. - The sport isn't supported on that device, such as a pool swim workout on a bike computer.
- A target the device can't use, such as a power target on a watch with no power source paired, or a target type an older device predates. Depending on the device, it may drop the target or refuse the whole file.
- Too many steps. Very long workouts can exceed what an older device accepts. Split them, or simplify the repeats.
- A damaged or half-downloaded file. Download it again; a browser that "helpfully" renamed it to
.fit.txtalso counts. - The file is right, the device just hasn't looked. After copying to
NewFiles, eject properly and unplug; some devices only import on disconnect. A restart can help.
If a .FIT file won't import, the5krunner's free FIT file checker can tell you why. If the file came from Fit File Forge and still won't load, tell us at support@fitfileforge.com and attach the file.
Where to get workout files
You can make one yourself with the Garmin Connect builder (it creates the workout directly; see three ways to put a workout on your watch), get one from a coach or plan, or download one. Every session in the Workout Library is a free .FIT download, set in relative targets so it fits your numbers:
Free .FIT downloads to try
Sources
- Garmin. FIT SDK: Overview and Profile. Garmin Developers.
- Garmin. FIT SDK: Cookbook (Encoding Workout Files). Garmin Developers.
- Garmin. Garmin device owner's manuals: Transferring Files to Your Device. Garmin Support.
Written by Caleb Wetherell; drafted with AI assistance and checked against the sources below.
Training information, not medical advice.
Want this at your paces, on your watch?
Describe it in plain words: your coach builds it at your numbers, ready to send to your Garmin.
Your coach drafts your first week free, from your Garmin training. No card.