Mapster WP Maps


Mapster’s on a mission! With Mapster WP Maps, we’re trying to make the best map editor and creator available for WordPress. So many of the existing plugins out there are outdated, difficult to use, and, worst of all, hide really basic features behind a paywall.

Check out Mapster WP Maps Pro for much more advanced features such as mass editing, huge imports, store locators, hover styling, and more.

With WordPress Maps, we currently integrate MapLibre (the open source Mapbox), Mapbox, and Google Maps.

Learn more about the plugin, get started, and check out the documentation at

We also have a site full of examples at!

You can use this plugin with or without access tokens and API keys, however you need.

A few features across different map types include:

  • Live map editor as you change and edit your map
  • Ability to add circles, markers, text, lines, polygons, and popups to your maps, and style them in many ways
  • Unlimited number of maps, unlimited features and markers
  • Control over map size, display, controls on the map, interactivity, and more
  • Integration of location searches, directions plugins, and more to come

We have a feature request forum open where you can feel free to submit feature requests and we will prioritize and respond to these.

This plugin effectively replaces our previous WP Mapbox GL JS plugin, which was a bit old and difficult to develop. This new plugin is much simpler to use and allows much more efficient development and bug fixing.

We have some FAQs and instructions up at, with more coming in the coming months! Please hit us up with any feature requests or bugs that you run into.


Your Friends at Mapster


  • Map editing interface.
  • Filter by distance with geocoding.
  • More editing.


This plugin provides 2 blocks.

  • Mapster Map Select
  • Mapster WP Maps


  1. Upload mapster-wp-maps.php to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Add an Access Token if you would like to use custom Mapbox styles or geocoders
  4. Click on “Maps” to start building your maps.
  5. Use the provided shortcodes to output these maps in your posts or widgets.


Something seems broken!

Get in touch with us at and we’ll message you back right away.

I’m not sure which type of map I should make!

No worries, we have posts to help you understand at

Do you have X feature?

Email us at, write a feature request, or leave a comment in the WordPress Support Forum.


May 17, 2024 1 reply
I tested many map plugins, and most were messy and outdated. This one stands out as the most powerful and clean map plugin by far. It has advanced features for creating all types of maps. Some notable differences compared to other plugins are:- Clean interface that uses the default WP style- Lightweight; only loads CSS/JS where used.- Plenty of advanced features, even in the free version (thank you).
January 22, 2024
I have long lost count on how many different types of plugins I have tried for maps. Since I found Mapster I have stopped looking. I have a very demanding and very specific need with literally thousands of locations, lines and areas that needs to be added, with custom pins, and there is simply nothing else that does it so well as this one, even in the free one. On top of all, Victor is amazingly responsive and helpful.
January 12, 2024
This plugin can do so many things, especially if you want to step away from google maps (GDPR anybody?). I can only recommend the PRO version, its features give it that extra edge that managing big websites or complicated imports becomes much less stressy and time consuming. Victor is very dedicated with the support, answers in 24h and always has a solution or a coherent explanation. Thumbs up
December 18, 2023
Great plugin and super support. I had a little issue that was promptly resolved by the developer! Thanks a lot!
November 17, 2023
By far the best maps plugin available huge customisation options and excellent support – highly recommended
Read all 37 reviews

Contributors & Developers

“Mapster WP Maps” is open source software. The following people have contributed to this plugin.


Translate “Mapster WP Maps” into your language.

Interested in development?

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



  • Updating Mapbox GL JS to v3.1.2
  • Adding marker color option for geocoder
  • Updating image thumbnail sizes for sidebar slideshow images
  • Updating ACF and more deprecation notices for PHP 8.2+
  • Allowing display for non-category symbols during category clustering
  • Bug fixes


  • Stamen tiles update (still not open except from localhost)
  • Adding cooperative gestures
  • Fix to filter dropdown clicking in some browsers
  • Changing how symbols show/hide during category filters
  • Centering coordinates when edited manually in Locations
  • Adding listing specialty map
  • Ability to open directly to modal
  • Popups working on 3D models
  • Fix on directions layers not appearing (not detecting loaded state)
  • Prevent focus on popups when opened
  • Store hours properly hidden
  • Google Maps Store Locator Mobile fix, scrolling fix
  • PHP 8 fix for deprecated dynamic properties
  • Security fix for shortcode XSS vulnerability


  • Ensuring borders are hidden when circles are hidden
  • Prepping for major update of Maplibre version
  • Fixing some mobile popup issues with Maplibre
  • Popup image resolution options added
  • Adding additional geolocation options
  • Fixing reloading of custom icons on default style switch
  • Interactions between search filter and category toggle
  • Updates for PHP 8.1
  • Fix for cursors on label icons with popups
  • Moving cache generation to wp-uploads
  • Fix to user submission posts showing in single feature shortcodes


  • Ability to create map caches
  • Simplification tool for shapes
  • Properly output content in feature object
  • Hovering bug fix for overlapping polygons


  • User submission datepicker bug
  • Modals able to render shortcode content
  • Category option to have numbers rendered
  • Ability to show category name as cluster instead of number
  • Freemius update


  • Previews for specialty map types
  • Improving modal close button
  • Renaming Mapbox Style URL to Style URL for all providers
  • Added ESRI Satellite layer
  • Layer control error correction
  • Improved user submission flow
  • Removing references to CSV regular importer
  • Adding features images to maps


  • Fix for popup image backgrounds
  • Incorrect update


  • User Submission error
  • Ensuring custom HTML shows correctly in map edit
  • Removing unneeded vendor files
  • Mass Edit for showing map in post
  • Correcting import count on title
  • GeoJSON download button fix
  • User Submission edit post display script fix
  • Map style slider beta
  • Heatmap beta
  • Reorganize map editor tabs
  • Elevation map beta
  • Fix for none permalink type
  • Download only included fields
  • Ensuring general and specific hooks both run


  • Fix to accordion layout (oops)
  • Ensuring premium plugin deactivates free plugin without an error
  • Improving script loading by pre-compiling
  • Restricting enqueued backend scripts to appropriate post types
  • Fixing click-to-link so doesn’t open when disabled
  • Fixing overflow scroll on List Control
  • More elegant marker clustering (no flash of single markers)
  • Ability to set number of search results for Custom Search Filter
  • Style switcher control
  • Layer switcher control
  • Different search options for Custom Search Filter


  • Removing extra field User Submission
  • Minor CSS fixes User Submission


  • Removing test code limiting uploads /facepalm


  • Fixes to category marker clustering


  • List control mobile layout fix
  • Limited geocoder country fix
  • Shortcode generator for features
  • Setting default template map
  • Improving centering of popups
  • Update instructions for importing shapefiles
  • Improving hover flickering on polygon popups
  • Completing first version CSV import
  • Fix to 3D terrain adding
  • Hovering on layer features improved
  • Extra list elements removed category filter
  • Speed improvements in Pro
  • Move attribution control
  • Move logo position
  • Allowing category exclusion for filter
  • Collapsible menu for category filter
  • Improved loading UX
  • Fixing icon size bug with large images


  • Added indicators of current map details in Manual Center and Zoom
  • Fixing geolocation on load bug
  • Custom list control store locator button
  • Fill extrusion bug fix


  • Extend zooming functionality to non-markers in List
  • Adding functionality for zoom on click popups


  • Allowing disable rotation and pitch
  • Adding functionality for center on click popups


  • Fix to embed code
  • Allowing uploading errored geojsons
  • Ability to change editing map style


  • Fixing encoding in Dropdown List
  • Mobile breakpoints
  • Update to latest ACF version, extracting styles


  • Improvements to User Submission
  • Expandable map edit screen
  • Download geoJSON edit screen
  • Showing proper labels for complex ACF fields
  • Adding Gutenberg selection block for map
  • Custom Images as base maps
  • Fix to map rotation (bearing)


  • Labels on checkboxes for filter
  • Strings for User Submission
  • WPML integration User Submission
  • Editing permissions User Submission


  • User Submission popups
  • Adding link to store locator fields
  • Category filter interact with Store Locator
  • Multi features initial shape


  • Restriction of user movement on map
  • Allowed area during user submission
  • Adding custom HTML control
  • Adding CSV export user submissions
  • Adding clustering by category
  • Translation strings for submission process


  • Bug fix layer trigger popup on load


  • Revision of user submission


  • Geocoder control fix


  • Ensure code fields show up in Free version
  • Adding globe view
  • Add geolocation on by default to control
  • Properly render HTML entities in Custom Search Filter
  • Remove marker from Custom Search Filter, add automatic popup open on markers


  • Open popup on feature layer on map load
  • Bug related to lines automatically showing dashes
  • Bug with X/Y positioning on labels and icons in production
  • Adding function to add category to a div
  • Making sure properties formatted properly when objects
  • Bug editing features in user submission with template overwrite
  • Loading support for Elementor elements
  • Unhiding height fields
  • Adding custom lat/long and zoom options to shortcode


  • Layout user submission
  • Adding wrapper, CSS, JS to user submission


  • Bug with duplication importing
  • Migration tool and documentation
  • Category fix
  • Semantic change user submission


  • First implementation 3D models
  • Adding starter tutorial
  • ListControl fix


  • Adding custom spatial database
  • Adding MultiPolygon, MultiLineString editing
  • Spatial API 1.0
  • Fix for local ACF and ACF Pro


  • Minor Mass Edit js bug


  • Full width fix for all containers
  • Optional widths for sidebar
  • Secondary categories in advanced importer
  • Adding dynamic features to custom HTML popup templates
  • Gallery margin-left fix


  • Adding custom style JSON
  • Google Maps first integration
  • Hiding Mapster WP Maps ACF field


  • Import bug with many properties
  • Mass edit small bug


  • Map projections
  • Update Mapbox 2.8.2
  • Adding 3D models first pass


  • Clustering for markers
  • 3D extrusions
  • Pitch and rotate enabled


  • Hover effects for popups


  • Custom HTML for popups


  • Integrating Freemius


  • Updates for WPML fetch all language posts
  • Fixing front end geocoder


  • Adding map display to location, line, and polygon post types
  • Fatal error
  • Image issue fixed


  • Major PHP bug fixed


  • CSS Admin menu
  • Domain fix


  • Popups stay open on mouse hover option
  • Customizable permalinks
  • Breaking errors


  • Numerous bug fixes
  • Splitting plugin into Basic and Pro
  • Quality of life fixes


  • Editor bug fixes
  • Marker overlapping bug fix


  • Bug fixes custom scripts
  • Allowing large file uploads


  • Bug fixes marker popups and dropdown list


  • Rewrite to make plugin more extendable and developer-friendly
  • Store locator functionality and addon
  • Numerous smaller bug fixes


  • Allow MultiLineString and MultiPolygon uploads into features
  • Significantly expanded Store Locator functionality
  • Prepping for addon plugins


  • Adding user submission of features
  • Bug with search filter not loading geocoder


  • Allowing category filter to be initialized “off”


  • Updating initial bounds zoom
  • Some issues with the last update, missing scripts


  • Improvement to script loading
  • Placeholder option for list control
  • Ability to turn off map horizontal duplication


  • Conditional script loading
  • Editor improvements adding/deleting
  • Editor improvements clustering icons
  • Addition of gallery slideshow to popups
  • Ability to open popups in a sidebar instead
  • Ability to enter in location coordinates directly


  • More API bug fixes


  • Bug fixes editor
  • Bug fixes API
  • Marker fix for category filter


  • Marking some features as in development
  • Improving marker image sizes


  • Improving marker clicks during mobile
  • Major loading improvements for larger maps


  • Fixing multiple maps on one page
  • Cross-origin image fix
  • Properly calling titles for filters
  • Click hover popups in mobile


  • Increasing specificity of button styles
  • Adding geosearch to Lines and Polygons


  • Fix pointer background bug
  • Easy duplication of posts
  • Improved bounds loading
  • Marker click to URL


  • Import geoJSON
  • Ability to interact via custom scripts
  • Full width maps
  • Fixed Safari/Firefox icon bug


  • Import from Mapbox WP GL JS
  • Add/remove features by category


  • Complete rewrite with ACF and jQuery


  • Adding Mapbox Terrain
  • Adding custom tilesets
  • Set view with a button
  • Tutorial links


  • Switching Mapbox 1.13 to MapLibre


  • Adding delete functionality
  • Improving geocoding
  • Improving view control


  • Adding location geocoding


  • Push to do beta testing.