# 17-Aug-2026 — export OS Maps routes to GPX and attach them to a walk [ref #99](https://github.com/nbarrett/ngx-ramblers/issues/99)

## [build 834](https://github.com/nbarrett/ngx-ramblers/actions/runs/32036227122) — [commit 476f4dc](https://github.com/nbarrett/ngx-ramblers/commit/476f4dc21c45dd1a1503315768ebd65ac07ead7a)

_____

## What's new

You can bring a route from the group's OS Maps account onto a walk as a GPX file, or convert several saved routes at once. This page is the user guide: first the login, then attaching a route to a walk, then converting a list of saved routes.

## Add the OS Maps login

Open [Admin > Settings > System settings](https://ngx-ramblers.org.uk/admin/settings/system-settings?tab=external-systems&sub-tab=maps), then **External Systems** and the **Maps** tab. The OS Maps email and password sit next to the existing API key.

Until those are filled in, a walk with an OS Maps URL cannot be imported. You will see a warning instead of the import button, with a link through to System settings.

![](https://ngx-ramblers.org.uk/api/aws/s3/site-content/a6ac61c0-b5c5-4e6b-94f3-4bc41ff41328.png)

*Related Links > OS Maps: the URL and link preview are there, but Import is replaced by a warning until the OS Maps login is set up in System settings*

## Attach a route to a walk

Open the walk and tap **edit**. In **Related Links**, open the **OS Maps** tab.

Paste an `explore.osmaps.com/route/...` URL. The link preview appears with the OS Maps mark and the route title. An optional title field is there if you want a different label on the walk page.

Once the login is set up, **Import from OS Maps** appears next to **Unlink**.

![](https://ngx-ramblers.org.uk/api/aws/s3/site-content/1c78af6b-f634-406d-b086-4c8c7a310db4.png)

*Once the login is set up, Import from OS Maps appears next to Unlink, with the route title in the link preview*

Tap **Import from OS Maps**. The button shows *Importing from OS Maps…* while the file is fetched and attached to the walk. You can leave the page; the job keeps running in the background, with the same live progress and end-of-job report as a Walks Manager export.

When it finishes, the walk has a GPX file. **Follow this route** then appears on the walk page. If the walk has not been saved yet, save it to keep the file.

**Unlink** removes the OS Maps link from the walk. It does not remove a GPX you have already imported.

![](https://ngx-ramblers.org.uk/api/aws/s3/site-content/4799c050-8a65-430b-a89f-97a3aecb0681.png)

*Import from OS Maps in progress: the button shows Importing from OS Maps… while the GPX is fetched and attached*

## Convert several routes at once

From System settings, tap **Choose routes to convert**, or open [Walks Admin > OS Maps Routes](https://ngx-ramblers.org.uk/walks/admin/os-maps-export).

Tap **Load routes from OS Maps** to list the routes saved on the account. Search by title, then use **Show** to filter to imported or not imported. That filter stays in the web address, so you can bookmark a view.

Tick the routes you want, or **Select all**, then **Convert selected to GPX**. Imported routes stay marked, so next time you can see what is still to do.

Once a route has been imported, **Edit route** opens it on the map. You can change the line and save it again without first attaching it to a walk.

Walk Exports still only lists Walks Manager uploads. OS Maps convert jobs show their progress on this page.

## At a glance

- Add the OS Maps email and password in System settings, next to the existing API key
- On a walk, Related Links > OS Maps: paste the route URL, then **Import from OS Maps**
- Until the login is set up, a warning points you to System settings instead of the import button
- The import button shows *Importing from OS Maps…* while the file is fetched and attached
- Walks Admin > OS Maps Routes lists saved routes with date, title, distance and whether each one has been imported
- Search by title, filter to imported or not imported, select matches and convert those to GPX
- Imported routes can be opened with **Edit route** without attaching them to a walk
- Load, convert and import all run in the background, with the same live progress as a Walks Manager export
- Walk Exports only lists Walks Manager uploads, not OS Maps convert jobs