Docs

Everything you need to put your GPX, FIT, TCX and KML tracks on a WordPress site with WP GPX Maps.

Start here

1. Install WP GPX Maps from Plugins > Add New (or from wordpress.org) and activate it.
2. Upload your track to the Media Library: GPX, FIT, TCX, KML and KMZ files are accepted and checked.
3. In a post or page, add the GPX Map block and pick the track. Map type, colors, distance markers, chart and summary are in the block settings on the right.
4. Prefer shortcodes? [sgpx gpx="/wp-content/uploads/2026/10/my-track.gpx"] works in any editor, widget or page builder. The attributes have the same names as the block settings.

See it in three minutes:

Guides

• How to add a GPX track to WordPress: from the file to the map with elevation profile, step by step.
• From Strava, Garmin or Komoot to your WordPress site: how to export your activities and tours.
• A GDPR-friendly alternative to Komoot and Strava embeds: your routes without third-party pages in your posts.
• Switching from another plugin: OSM – OpenStreetMap, Lf Hiker, WP Trip Summary.
• Updating from 1.7 to 1.10: how to update safely if your site still runs an old version.
• 3D maps with Mapbox: get a free Mapbox key and turn on 3D terrain and satellite.
• GPX, FIT, TCX or KML: which file to export from your watch, bike computer or app.
• All the demos: every feature at work, from a short hike to the 769 km of the Camino Francés.

Reference

• All the shortcode attributes are listed in your site under Settings > WP GPX Maps > Help, with their current default values.
• Defaults for every map: Settings > WP GPX Maps > Settings.
• FAQ and changelog: on the wordpress.org page.
• Developers: hooks for add-ons, JavaScript events and how to build the plugin are on GitHub.

Help

Something does not work? Open a thread on the support forum with the URL of the page, the shortcode or block you use and, if possible, the GPX file. Fixes and improvements to the code are welcome as pull requests on GitHub.

WP GPX Maps is free and open source. If it is useful to you, leave a review or support the development.