Title: GPX Viewer
Author: axelkeller
Published: <strong>September 7, 2018</strong>
Last modified: March 16, 2026

---

Search plugins

![](https://ps.w.org/gpx-viewer/assets/icon-256x256.png?rev=3072516)

# GPX Viewer

 By [axelkeller](https://profiles.wordpress.org/axelkeller/)

[Download](https://downloads.wordpress.org/plugin/gpx-viewer.2.2.16.zip)

 * [Details](https://wordpress.org/plugins/gpx-viewer/#description)
 * [Reviews](https://wordpress.org/plugins/gpx-viewer/#reviews)
 *  [Installation](https://wordpress.org/plugins/gpx-viewer/#installation)
 * [Development](https://wordpress.org/plugins/gpx-viewer/#developers)

 [Support](https://wordpress.org/support/plugin/gpx-viewer/)

## Description

Displays a GPX track as segmented polylines, the way points and the elevation profile.

Open Street Map (OSM) is used as background which can be switched between a plane
view and a topographic one. The view can be changed to full screen mode. Moving 
the cursor over the elevation profile the corresponding point is marked on the path
interactively.

GPX tracks uploaded to the server in advance are stored into separate repositories
that are ordered according to the categories setup in wordpress.
 Thus different
collections of tracks can be handled and the tracks choosen from.

During upload a GPX track can be smoothed and/or its elevation data replaced by 
Open-Elevation Service data.
 The latter is provided because many elevation data
tracked by mobiles are not quite correct.

GPX trackpoints can be edited on the map interactively.

**Features**

 * Admin page _GPX Files_ for uploading tracks
    – Selecting category for repository–
   Replacing the description of the track (tag `<name>` in the GPX file) – Smoothing
   tracks during upload, thus reducing track points – Replacing elevation data of
   track points using Open-Elevation Service during upload
 * Display of a specific, uploaded GPX track
    – PHP-function for inserting the view
   into a page – Selecting full screen mode and scaling the map – Switching between
   plane and topographic view
 * Editing trackpoints on the map
    – Adding, moving, deleting track points – creating,
   splitting polylines
 * Display of a list of GPX files from which a track can be selected
    – separated
   list for each category – Setting width and color of the path – Shortcode for 
   inserting the list into a page
 * Elevation profile
    – Interactive path marker – Name of the track – Distance of
   the track – Maximum/minimum elevation – Elevation loss/gain – Trail duration

## Screenshots

 * [[
 * Track selected from a file list
 * [[
 * Editing trackpoints

## Installation

**Installation and Settings:**

 1. Upload the plugin files to the `/wp-content/plugins/<my-plugin-name>` directory,
    or install the plugin through the WordPress plugins screen directly.
 2. Activate the plugin through the _Plugins_ screen in WordPress
 3. Use the _Settings->GPX Viewer_ screen to configure the plugin at least one time(
    Measure Units, …)
 4. Accept the link to https://api.open-elevation.com in your browser

**Uploading GPX files:**

 * Goto _GPX Files_ in the admin menu
 * Choose category for repository: Uploaded file will be stored in directory `~/
   wp-content/uploads/gpx/<mycategory>/`.
 * Choose GPX file to upload
 * Optionally replace description of track (tag `<name>` in the GPX file)
 * Optionally smooth track during upload, i.e. reducing track points and smoothing
   elevation data
 * Optionally replace elevation data using Open-Elevation Service

**Basic usage:**

 * Calling the viewer for a specific GPX track:
 *     ```
       <?php 
           echo gpx_view(array('src'  => $filepath                $filepath = <absolute path>/wp-content/uploads/gpx/<mycategory>/<file>.gpx 
                           [, 'title' => $track_name]
                           [, 'color' => $track_color]
                           [, 'width' => $track_width]
                           [, 'download_button'=> true/false]));
       ?>
       ```
   
 * Shortcode to include a GPX track for a given category into a WordPress-page.
 *     ```
       [gpx-view category="<mycategory>" gpx-file="<filename>"]
       ```
   
 * Shortcode to include the list of the GPX files for a given category into a WordPress-
   page. From this list a track can be selected and displayed.
 *     ```
       [gpx-view category="<mycategory>"]
       ```
   
 * Shortcode to open a gpx track locally for editing. The result can be stored again
   locally.
 *     ```
       [gpx-view]
       ```
   
 * Shortcode to display the gpx track with given color and/or width.
 *     ```
       [gpx-view ... color="<rgb-color>" width="<number>"]
       ```
   

## Reviews

![](https://secure.gravatar.com/avatar/acad629a98ed21690104a12fa7c41f8a59feebb39c867de15e4b60aca54f4332?
s=60&d=retro&r=g)

### 󠀁[Good, fast and simple GPX Viewer](https://wordpress.org/support/topic/good-fast-and-simple-gpx-viewer/)󠁿

 [ltm66](https://profiles.wordpress.org/ltm66/) February 23, 2026

Good GPX viewer, simple and fast, with OpenStreetMap and OpenTopoMap capability.
I still have to try it with different types of GPX files, but the premises seem 
good to me

![](https://secure.gravatar.com/avatar/f9e2044ad390fcd1b9f66c8a5aa1985a21ddd28f38554d28eb284dfcb89142a6?
s=60&d=retro&r=g)

### 󠀁[Breaks Gutenberg](https://wordpress.org/support/topic/breaks-gutenberg/)󠁿

 [kevinlg](https://profiles.wordpress.org/kevinlg/) January 15, 2026

My Gutenberg blocks kept breaking, and I couldn’t figure out why. Turns out it was
this little weasel right here… Stay clear from it.

![](https://secure.gravatar.com/avatar/76347566b493666f6c96dae324c7d6f16e9954b9014f2c11bb0fa9880e0d0acc?
s=60&d=retro&r=g)

### 󠀁[Gutes Plugin](https://wordpress.org/support/topic/gutes-plugin-71/)󠁿

 [landomaaat94](https://profiles.wordpress.org/landomaaat94/) May 7, 2024

Great plugin, does exactly what it’s supposed to. From me, it’s 4 stars. If there
are no security issues, it’s a solid 5-star rating. @ Alex How about the code quality
here? I’ve installed Wordfence on my project and after 3 hours, a security notice
popped up indicating that the file had changed. No malicious code can be injected
here, right? I look forward to your feedback 😀 Filename: /…/…/…/wp-content/plugins/
gpx-viewer/js/gpxCleaner.js Message Wordfence: This file belongs to plugin “GPX 
Viewer” version “2.2.5” and has been modified from the file that is distributed 
by WordPress.org for this version. Please use the link to see how the file has changed.
If you have modified this file yourself, you can safely ignore this warning. If 
you see a lot of changed files in a plugin that have been made by the author, then
try uninstalling and reinstalling the plugin to force an upgrade. Doing this is 
a workaround for plugin authors who don’t manage their code correctly.

![](https://secure.gravatar.com/avatar/c8e5e786f6ce6d6cb8346c80c8dfdad365adae1864f4307505a777fe1297c0f9?
s=60&d=retro&r=g)

### 󠀁[Great potential](https://wordpress.org/support/topic/great-potential-39/)󠁿

 [porkburn](https://profiles.wordpress.org/porkburn/) September 2, 2022

This plugin has great potential to become a full running statistics for WP Idea:–
Week, month and year state – Maybe something like citystrides.com (were you run 
all the streets in a city) – Sotering at various clubs and or areas

![](https://secure.gravatar.com/avatar/31e534764fa15e1cfb33777225c269ad6d7155f60561206ed6c62f1c1ce7d254?
s=60&d=retro&r=g)

### 󠀁[A very good plugin for distributing GPX files](https://wordpress.org/support/topic/a-very-good-plugin-for-distributing-gpx-files/)󠁿

 [Sandy Janas](https://profiles.wordpress.org/apjanas/) August 20, 2022

This plugin is just what I’ve been looking for and does the job well. Just a few
points, firstly the full-screen mode doesn’t seem to work with Safari browser (you
get a black screen), although it seems fine with every other browser I’ve tried,
secondly, I’ve had to add a css statement .content { width:100%; } to get the table
to float alongside the graph on Safari. These are probably Safari quirks rather 
than problems with the plugin. One other thing: I’d like a way to display the Author
of the GPX file, to give them credit for it. Apart from those issues, I really like
this plugin very much.

![](https://secure.gravatar.com/avatar/5f9c1f751318d967356ed7a6b7ff32ebcb6c269403757dab94e4c5907efe2990?
s=60&d=retro&r=g)

### 󠀁[Nice idea – but doesn’t work at all…](https://wordpress.org/support/topic/nice-idea-but-doesnt-work-at-all/)󠁿

 [drohdekage](https://profiles.wordpress.org/drohdekage/) December 27, 2021 2 replies

…you should not complain about Opensource-tools, but this one is simply not working–
and posted issues are completely ignored.

 [ Read all 8 reviews ](https://wordpress.org/support/plugin/gpx-viewer/reviews/)

## Contributors & Developers

“GPX Viewer” is open source software. The following people have contributed to this
plugin.

Contributors

 *   [ axelkeller ](https://profiles.wordpress.org/axelkeller/)

“GPX Viewer” has been translated into 4 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/gpx-viewer/contributors)
for their contributions.

[Translate “GPX Viewer” into your language.](https://translate.wordpress.org/projects/wp-plugins/gpx-viewer)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/gpx-viewer/), check
out the [SVN repository](https://plugins.svn.wordpress.org/gpx-viewer/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/gpx-viewer/) by 
[RSS](https://plugins.trac.wordpress.org/log/gpx-viewer/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 2.0.0

 * Editable trackpoints
 * Handling of GPX segments as separated polylines
 * Full screen mode using the whole screen

#### 2.1.0

 * Editing trackpoints of locally opened gpx files

#### 2.1.1

 * corrections for editing trackpoints of locally opened gpx files
 * correction of missing return value in shortcode function

#### 2.1.2

 * scalebar added to maps

#### 2.1.3

 * In shortcode procedure the function for searching category terms corrected

#### 2.1.4

 * Topographic map view added

#### 2.1.5

 * Error correction: Edited gpx tracks couldn’t be updated or stored

#### 2.1.6

 * Error correction: Error when displaying categories in admin screen

#### 2.1.7

 * Error correction: Error when displaying categories in admin and edit screen

#### 2.1.8

 * Code review

#### 2.1.9

 * Enhanced trackpoint reduction for decending slopes

#### 2.1.10

 * Working search function for track list

#### 2.1.11

 * GPX tracks with valid xml schema (gpx.xsd) when exported

#### 2.1.12

 * Showing elevation profile if all elevation values are less than 0

#### 2.2.0

 * MapQuest Elevation Srvice replaced by Open-Elevation Service

#### 2.2.1

 * Shortcode for embedding a single track into a WordPress-page

#### 2.2.2

 * Minor Enhancements

#### 2.2.3

 * Corrections uploading gpx file, writing track name

#### 2.2.4

 * Corrections displaying track name, shortcode with color and width

#### 2.2.5

 * enabling editing of new tracks

#### 2.2.6

 * displaying distances and elevation heights within gpx file lists

#### 2.2.7

 * gpx-viewer works using block (FSE) themes

#### 2.2.8

 * storing new tracks with gpx editor

= 2.2.9
 * avoid errors from Open-Elevation when saving edited tracks with single
points

= 2.2.10
 * vulnerability remediation

= 2.2.11
 * checked security issues

= 2.2.14
 * solved storing new tracks

= 2.2.15
 * saving tracks in reverse

= 2.2.16
 * highlighting selected filename

## Meta

 *  Version **2.2.16**
 *  Last updated **4 weeks ago**
 *  Active installations **900+**
 *  WordPress version ** 4.9 or higher **
 *  Tested up to **6.9.4**
 *  PHP version ** 7.2.24 or higher **
 *  Languages
 * [Dutch](https://nl.wordpress.org/plugins/gpx-viewer/), [English (US)](https://wordpress.org/plugins/gpx-viewer/),
   [French (France)](https://fr.wordpress.org/plugins/gpx-viewer/), [German](https://de.wordpress.org/plugins/gpx-viewer/),
   and [Greek](https://el.wordpress.org/plugins/gpx-viewer/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/gpx-viewer)
 * Tags
 * [elevation](https://wordpress.org/plugins/tags/elevation/)[GPX](https://wordpress.org/plugins/tags/gpx/)
   [map](https://wordpress.org/plugins/tags/map/)[openstreetmap](https://wordpress.org/plugins/tags/openstreetmap/)
   [track](https://wordpress.org/plugins/tags/track/)
 *  [Advanced View](https://wordpress.org/plugins/gpx-viewer/advanced/)

## Ratings

 3.6 out of 5 stars.

 *  [  3 5-star reviews     ](https://wordpress.org/support/plugin/gpx-viewer/reviews/?filter=5)
 *  [  2 4-star reviews     ](https://wordpress.org/support/plugin/gpx-viewer/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/gpx-viewer/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/gpx-viewer/reviews/?filter=2)
 *  [  2 1-star reviews     ](https://wordpress.org/support/plugin/gpx-viewer/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/gpx-viewer/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/gpx-viewer/reviews/)

## Contributors

 *   [ axelkeller ](https://profiles.wordpress.org/axelkeller/)

## Support

Issues resolved in last two months:

     0 out of 2

 [View support forum](https://wordpress.org/support/plugin/gpx-viewer/)