• Easy to use, customisable and developer friendly.
  • Use the Editor to create Maps containing Overlays (Markers, Lines and Shapes).
  • Every Overlay can be given a title, image and description; which is displayed once the Overlay is clicked.
  • Set styles and options once using Types, then simply select the appropriate Type when adding an Overlay.
  • Add Maps to your content using the Waymark Shortcode, or link to the Map Details page.
  • OpenStreetMap is the default Basemap, with support for multiple Basemaps.
  • Images uploaded with location data (EXIF) will have a Marker placed where the photo was taken.
  • Import from GPX, KML and GeoJSON formats. You can export Maps in the same formats and let your visitors do it too.
  • An interactive profile chart can be displayed for Tracks uploaded with elevation data.
  • Group Maps together using Collections and display multiple Maps at once.
  • Add extra information to your Maps using Meta; these are customisable form inputs that allow you to add additional data to your Maps.
  • Submissions allow registered users, or guests to create Maps from the front-end of your site. You can control who can Submit Maps, what editor features are available and whether submissions should be approved before they are published.
  • For the developers: Maps are stored using the custom post type waymark_map, Meta is stored as Custom Fields and Collections use the waymark_collection Taxonomy. Most elements can be styled using CSS and have sensibly named waymark- classes.

Waymark is free, with no features to “unlock”. I try to keep the plugin well supported, so please feel free to reach out with any questions or feedback.


  • Add Overlays (Markers, Lines and Shapes) to create detailed interactive Maps. You can import/export from GPX/KML/GeoJSON.
  • Every Overlay can be given a title, image and description. Marker images can be displayed as a gallery.
  • Waymark features a clean, intuative Editor for creating and editing your Maps. Overlays are customisable using Types, which allow you set styles once (colours/icons etc.), so you can simply select it when you are adding to the Map.
  • If you have more than one Basemap, you can switch between them when viewing the Map. Overlays can be shown/hidden by Type.
  • Use Meta to provide extra information about your Maps. Meta inputs are customisable and can be grouped.
  • The Map Details page displays an image gallery, elevation profile, export options, featured image and all Meta provided for the Map.
  • Add Maps to your content using the Waymark Shortcode. You can choose which Meta is displayed.
  • Organise Maps with Collections and display multiple Maps at once using the Shortcode. Collections can be nested and Maps can be associated with multiple Collections.
  • Waymark was designed to be very flexible, with lots of Settings to choose from.


With Waymark enabled, click on the “Maps” link in the sidebar to create and edit Maps. Once you are happy with your Map, copy the Waymark shortcode and add it to your content.

Read the Docs »


Is There a Demo?

Yes, here.

Can I Get More Help?

Yes, please view the Documentation.

Does Waymark Support Google Maps?

While Google Basemaps can be added to Waymark, Waymark does not use the Google Maps API (it uses Leaflet). There are other plugins available that are made specifically for Google Maps.

Can I Translate the Plugin?

Please! Waymark is localization ready, translation contributions are greatly appreciated.


Waymark relies on input from it’s users, thank you to everyone for providing feedback 🙂

A big thank you to the following projects and their contributors. Without their work this plugin would not be possible:


December 26, 2022 1 reply
Traveling the world, I was looking for a possibility to share my journeys and experiences with friends. I decided to setup my own travel blog with WP and found this excellent plugin to be best suited for: Remaining independent from data collecting companies Showing routes and visited places Allowing to link Markers and Routes to text and images Upload GPX data Very much appreciated
August 31, 2022 1 reply
I've tested almost all Wordpress mapping plugins, and this one is by far the winner for the following reasons: it is easy to learn & master & customize it it includes all most important features (some are not even existing in any other plugin) the author is great in supporting it quickly All of this for free, which is not negligible...
July 24, 2022 1 reply
Excellent Plugin, simple to use and customize. Fantastic and always available instructions and support. Thanks and congratulations !! good job
February 8, 2022 1 reply
`I like to watch how the plugin develops. If even more functions are integrated, a PRO version would certainly be an option. What I do not like at the moment is that probably no lightbox is supported for the images. Without the Lightbox support it is very frustrating when users click on the images (I use the Kadence Theme with the integrated Lightbox function, but two alternative Lightbox plugins have unfortunately not worked).
September 10, 2021 4 replies
Hello, I'm trying to understand the plugin. I tried several tests for a week. I am testing how the plugin responds to which process. I found it quite successful. My only wish is to support the webp format. I get php error when uploading photos in webp format via media library. waymark plugin deletes exif data in webp photos. I will be very happy if the webp format is supported. Thank you to those who contributed.
August 5, 2021 1 reply
After using many gpx plugins to chart our bicycle holidays, lastly using lfhiker, I finally found Waymark, which suits my need for minimal display of routes and interesting points along the way. After a bit of a learning curve to get the attributions for extra basemaps right, I find this plug in the *****very best*****
Read all 27 reviews

Contributors & Developers

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


“Waymark” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “Waymark” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.


  • Fixed map data container bug, which was causing Map Data not to save.


  • Settings navigation improvements.
  • Submission localization fixes.
  • Minor bug fixes.


  • Editor popup redesign, including Type previews.
  • Front-end Submissions improvements.
  • Lots of other bug fixes and improvements.


  • Bug fix


  • Ignore file extension capitalisation when reading from file. This was a bug that meant reading from file.GPX (instead of file.gpx) was rejected for no good reason.

Credit to Werner for getting in touch and prompting these changes.


  • Bug fix. Uncaught TypeError: Assignment to constant variable. Thanks to huubl for the Pull Request!


  • Front-end Submissions can now be added to a Collection by default. A collection for User and Guest submissions can be specified in Settings > Submissions > Default Collection.


  • Shortcode Files
    • Files (GPX, KML & GeoJSON) can now be displayed using the Shortcode, without the need for a Map to be created. For example:
      [Waymark file_url="http://example.com/track.gpx"]
      By default, all Overlays (Markers/Lines/Shapes) will be displayed using the default Type (i.e. the first listed in Settings). You can specify a different Type to use like this:[Waymark file_url="http://example.com/track.gpx" file_line_type="photo"]. Thanks to Jan de Boer for this suggestion and yorobo for the reminder.


  • Submissions
    • Allow registered users, or guests to create Maps from the front-end of your site. You can control who can Submit Maps, what editor features are available and whether submissions should be approved before they are published. Originally suggested here.
  • Shortcode Markers
    * Markers can now be displayed using the Shortcode, without the need for a Map to be created. For example:
    [Waymark marker_centre="54.526814,-3.017289" marker_type="shelter"]
    As well as the Marker location and Type; a Title, Description and an Image can also be provided. Thanks to Angelo Mariani for this suggestion.
  • Fixed a bug where Shortcode Headers were not displaying on Collection archive pages. Thanks to meggsico for bringing this to my attention.
  • Improved “accidental zooms” when scrolling by increasing the Leaflet.Sleep wakeTime from 1 second to 2 seconds. As requested.
  • Lots of back-end fixes and improvements.

  • Fixed a bug where the Export feature did not work correctly when embedding multiple Maps. Thanks to shenki on GitHub.
  • Waymark now has it’s own website! URLs updated.


  • Maps
    • Maps now support Featured Images; if provided this will be displayed on the Map Details page, as well as by the Shortcode. Thanks to David for the suggestion!
  • Markers
    • Marker Icons can now be custom text or HTML (in addition to Font icons from Ionic Icons and Font Awesome). Thanks for the suggestion!
    • Map Exports are now available on mobile devices.
    • Updated Acknowledgements.
  • Bug fixes
    • Settings JavaScript fix.
    • Settings repeatable dropdown bug.
    • Settings input sanitisation.

A BIG thank you to the following users for their help with testing:


  • Markers
    • Markers can now be different shapes! Markers, Circles or Squares in three different sizes: Small, Medium and Large.
    • Markers can now have any colour background, selected using the colour picker or by entering a hexadecimal color (i.e. #RRGGBB)
    • Markers now support Font Awesome icons as well as Ionic Icons.
  • Types
    • Type labels displayed by popups now match the colours of their respective Marker, Line or Shape.
  • Media Library Uploads
    • By default Waymark does not save any files uploaded through the Editor. Using this option you can use the Media Library to store and import GPX/KML/GeoJSON files into your Map.
  • Bug fixes

  • Localization fixes. Thanks to tobifjellner for the help via Slack.

  • Bug fix. Thanks to cameraspots1 for bringing this to my attention.


  • Meta
    • Meta can now be organised into groups. Meta in the same group will be displayed together when editing and viewing Maps. Groups can be managed in Settings > Meta > Groups.
    • New layout for Meta to incorporate Meta Groups on Map Details page.
  • Shortcode
    • Meta can now be displayed using the Shortcode by clicking “Details” in the Shortcode Header. Use the Settings > Meta > “In Shortcode?” option to specify which Meta is displayed. Note: this feature requires the Shortcode Header be set to “Show” in Settings > Misc. > Shortcode Options.
    • The Export option is now available through the Shortcode, if the “Public Export” option is enabled (Settings > Misc. > Map Options).
  • Editor
    • Overlay descriptions now use a rich text editor.
    • Added the ability to duplicate Markers/Lines/Shapes in the Editor.
    • Editor circle bug fix.
  • Gallery JavaScript bug fix.
  • Waymark is now localization ready! Translation contributions greatly appreciated 🙂
  • Waymark is now on GitHub.


  • Line Elevations – Display an interactive elevation graph for Lines that have elevation data. Minimum/Maximum elevation and total length statistics are also displayed. Customise in Settings > Misc. > Elevation Options. Thanks to leaflet-elevation!
  • Cyrillic alphabet fix.
  • GPX parsing fix.
  • Updated user capabilities for plugin features.
  • Other bug fixes.

A big thank you to everyone who provided input for this release. Extra special thanks goes to coloursign, meggsico, davinian, snake-plissken, sunlight1976 and bumbar for their help with testing.


  • Overlay Filter – This allows your visitors to filter which Markers, Lines and Shapes are currently visible on the Map by clicking on the layer icon. You can choose to show/hide certain Types when the Map initially loads. Enable using the global setting (Settings > Misc. > Map Options), or using the Shortcode.
  • Export – There is now an Export function when editing a Map. With “Public Export” enabled (Settings > Misc. > Map Options) site visitors can download the Overlays (Markers, Lines and Shapes) currently displayed on the Map Details page. Can be used in conjunction with the Overlay Filter to select which Overlays to download. GeoJSON, GPX and KML formats supported.
  • Meta – Added Rich Text, Select and Multi-Select input types.
  • Bug fixes.

Thanks to neilhorton740, carldavidcarlstrom, and coloursign for testing and feedback.


  • Gallery – Added the option to display an image gallery for Markers that have images associated with them. Can be changed in Settings > Misc. > Map Options. Can be enabled using the show_gallery=”1″ Shortcode option.
  • Created Waymark Documentation.
  • Updated the Demo.
  • First steps towards Localization.
  • Added the ability to change Map author. Thanks to andreasrns for the suggestion.
  • Maps now support Revisions.
  • Added “Header for Admin” to Settings > Shortcode Options. Use this Setting to always show the Shortcode Header when signed in as admin, useful for quickly navigating to embedded Maps.
  • Fixed a bug where circles were being added as Markers.
  • Removed undocumented shortcode button in Classic Editor.
  • Fixed Leaflet JS conflict when other instances of Leaflet exist. Thanks to jmruas for bringing this to my attention.
  • Fixed a bug where Types were not being saved for Markers/Lines imported from file.
  • Other minor improvements.

A big thanks to neilhorton740 and carldavidcarlstrom for bug finding and testing.


  • Collections – Can now be given a description and viewed as an archive (lists Maps in that Collection) on the front-end. A link is displayed on the Map Details page (Collection links support permalinks)
  • Map URLs now support permalinks
  • Added the ability to duplicate Maps
  • In the Editor, Markers now display their Lat,Lng
  • Lots of other improvements and bug fixes

Thanks to neilhorton740 and carldavidcarlstrom for suggestions and testing.


  • Shortcodes – Added the ability to specify initial Map centre and zoom through the Shortcode: [Waymark map_centre=”,” map_zoom=”<0-18>”]. Shortcodes no longer require a Map ID/Collection ID. Added Using Shortcodes section to Help page.
  • Maps – Added setting for Default Centre/Zoom when a Map has no data to display.
  • Collections – Added the option to display a link to Map Details pages from Collections
  • Improved Settings input sanitisation
  • Lots more performance improvements and bug fixes

Another big thanks to neilhorton740 for suggestions and testing.


  • Release date: December 17th, 2019

Added the ability to specify a default basemap through shortcode: [Waymark map_id=”1234″ basemap=”Basemap Name”]. Which Basemap to use as the Map Editor default can also be specified in Settings > Misc. > Editor Options. Thanks again to neilhorton740 for the suggestion and testing.


  • Release date: December 5th, 2019

Added Line Weight setting for Lines and the ability to override the Shortcode Header setting through the shortcode. A HUGE thank you to neilhorton740 for the suggestions and testing.


  • Release date: November 8th, 2019

Added support for Meta, which allows you to customise the input fields that display under the Map Editor. Any data you input will display on the Map Details page. Plus some minor improvements and bug fixes.


  • Release date: October 28rd, 2019

Added support for Collections, which allow you to organise your Maps and display multiple Maps at once. Also more bug fixes.


  • Release date: October 23rd, 2019

Integrated leaflet-control-geocoder, thanks for the suggestion! Also minor fixes and tweaks.


  • Release date: October 11th, 2019

Bug fixes and improvements. Thanks again to rottensod!


  • Release date: September 4th, 2019

Bug fixes and minor tweaks. Thanks to rottensod for your bug finding efforts!


  • Release date: July 26th, 2019

Integrated Leaflet.Sleep into Waymark for better zoom/scroll event handling. Thanks to numeeja for this suggestion!


  • Release date: July 25th, 2019

Minor bug fix.


  • Release date: July 23rd, 2019

First public release of Waymark!