GPX files for cycling

What a GPX file is, and how to get one from your phone onto the bike computer you ride with.

A GPX file is a route saved as a list of map points, in a standard format almost every cycling app and bike computer can read. To ride one, open it on your phone, choose your bike computer's app from the list it offers, and send it to the device from there.

What is in a GPX file

A track is the exact line, as a long list of points. This is what a bike computer follows as a course.

GPX, the GPS Exchange Format, is a plain text file in XML, first published by TopoGrafix and now at version 1.1. Plain GPX has no standard place for turn-by-turn instructions: most bike computers work the turns out themselves from the track, and Garmin can also read TCX files, which carry a cue sheet.

Linje's saved routes, with a route's menu open: Rename, Edit route, Make available offline, Invite riders, Export GPX and Delete
A GPX imported into Linje: saved, and matched to the map, so wind, terrain and the best time all work on it

From Linje, and into it

Any saved route or recorded ride in Linje can be exported as a GPX file, ready to open in the apps below. It is version 1.1 with a single track, the height of every point and the turns as waypoints, which Garmin devices show as course points.

It goes the other way too: import a GPX from another app or a friend, and Linje matches it to the roads, so the wind, the terrain check and the best time to leave all work on it.

Onto your bike computer

Garmin Edge and Garmin watches

  1. Open the GPX file on your phone and share it to Garmin Connect. On an iPhone, tap Share and pick Garmin Connect, or tap More if it is not shown.
  2. Choose a course type, such as Road Cycling, rename it if you like and save.
  3. In Garmin Connect, go to More, then Training & Planning, then Courses. Open the course, tap the send icon and choose your device. It arrives on the next sync.
  4. On an Edge, find it under Navigation, then Courses.

Garmin Connect also takes .fit and .tcx. On the web, it is Training & Planning, then Courses, then Import. A device shows only the first 15 characters of a course name.

Finding the file on your phone

On an iPhone, a downloaded GPX is in the Files app, usually under Downloads. Touch and hold it, choose Share, and pick the app. On Android, tap it in your Downloads or Files app and choose the app from the list it offers. If the app you want is not listed, it is not installed.

Questions

What is a GPX file?

A GPX file is a route or ride saved as a list of map points in the GPS Exchange Format, an open XML format now at version 1.1. Almost every cycling app and bike computer can read one.

How do I put a GPX file on my Garmin?

Open the file on your phone, share it to Garmin Connect, choose a course type and save. Then send the course to your device from Training & Planning, Courses, and it arrives on the next sync.

What is the difference between a GPX track and a route?

A track is the exact line as a long list of points, which bike computers follow as a course. A route is a short list of turning points that a device finds its own way between.

Do GPX files include turn-by-turn directions?

Not as standard. Most bike computers work the turns out from the track. A GPX from Linje also carries the turns as waypoints, which Garmin devices show as course points.

Sources

Steps checked against each maker's own pages on . Apps change their menus; if a step here is out of date, write to hello@linje-route.com.

Where are you riding next?

Linje builds the ride, then works out when to leave and which way round. Join the waitlist for early access.