{"id":"6a8314fce1a8c96a76898961","title":"2026 08 17 Issue 99","path":"how-to/committee/release-notes/2026-08-17-issue-99","contentMarkdown":"# 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)\n\n## [build 834](https://github.com/nbarrett/ngx-ramblers/actions/runs/32036227122) — [commit 476f4dc](https://github.com/nbarrett/ngx-ramblers/commit/476f4dc21c45dd1a1503315768ebd65ac07ead7a)\n\n_____\n\n## What's new\n\nYou 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.\n\n## Add the OS Maps login\n\nOpen [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.\n\nUntil 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.\n\n![](https://ngx-ramblers.org.uk/api/aws/s3/site-content/a6ac61c0-b5c5-4e6b-94f3-4bc41ff41328.png)\n\n*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*\n\n## Attach a route to a walk\n\nOpen the walk and tap **edit**. In **Related Links**, open the **OS Maps** tab.\n\nPaste 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.\n\nOnce the login is set up, **Import from OS Maps** appears next to **Unlink**.\n\n![](https://ngx-ramblers.org.uk/api/aws/s3/site-content/1c78af6b-f634-406d-b086-4c8c7a310db4.png)\n\n*Once the login is set up, Import from OS Maps appears next to Unlink, with the route title in the link preview*\n\nTap **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.\n\nWhen 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.\n\n**Unlink** removes the OS Maps link from the walk. It does not remove a GPX you have already imported.\n\n![](https://ngx-ramblers.org.uk/api/aws/s3/site-content/4799c050-8a65-430b-a89f-97a3aecb0681.png)\n\n*Import from OS Maps in progress: the button shows Importing from OS Maps… while the GPX is fetched and attached*\n\n## Convert several routes at once\n\nFrom System settings, tap **Choose routes to convert**, or open [Walks Admin > OS Maps Routes](https://ngx-ramblers.org.uk/walks/admin/os-maps-export).\n\nTap **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.\n\nTick 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.\n\nOnce 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.\n\nWalk Exports still only lists Walks Manager uploads. OS Maps convert jobs show their progress on this page.\n\n## At a glance\n\n- Add the OS Maps email and password in System settings, next to the existing API key\n- On a walk, Related Links > OS Maps: paste the route URL, then **Import from OS Maps**\n- Until the login is set up, a warning points you to System settings instead of the import button\n- The import button shows *Importing from OS Maps…* while the file is fetched and attached\n- Walks Admin > OS Maps Routes lists saved routes with date, title, distance and whether each one has been imported\n- Search by title, filter to imported or not imported, select matches and convert those to GPX\n- Imported routes can be opened with **Edit route** without attaching them to a walk\n- Load, convert and import all run in the background, with the same live progress as a Walks Manager export\n- Walk Exports only lists Walks Manager uploads, not OS Maps convert jobs","contentHtml":"

17-Aug-2026 — export OS Maps routes to GPX and attach them to a walk ref #99

\n

build 834 — commit 476f4dc

\n
\n

What's new

\n

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.

\n

Add the OS Maps login

\n

Open Admin > Settings > System settings, then External Systems and the Maps tab. The OS Maps email and password sit next to the existing API key.

\n

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.

\n

\"\"

\n

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

\n

Attach a route to a walk

\n

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

\n

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.

\n

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

\n

\"\"

\n

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

\n

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.

\n

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.

\n

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

\n

\"\"

\n

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

\n

Convert several routes at once

\n

From System settings, tap Choose routes to convert, or open Walks Admin > OS Maps Routes.

\n

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.

\n

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.

\n

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.

\n

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

\n

At a glance

\n\n"}