MapPress Maps for WordPress


MapPress is the easiest way to add beautiful interactive Google and Leaflet maps to WordPress.

Create unlimited maps and markers using Gutenberg blocks or the classic editor. The popup map editor makes creating and editing maps easy!

Upgrade to MapPress Pro for even more features, including custom markers, searchable mashups, clustering, and much more. See it in action on the MapPress Home Page or test it yourself with a Free Demo Site!

Home Page
What’s New


  1. Deactivate your old MapPress version
  2. Delete your old MapPress version (don’t worry, the maps are saved in the database)
  3. Follow the installation instructions to install the new version


  • MapPress settings page
  • Map Library in Gutenberg
  • Creating a map
  • Creating a mashup
  • Best Google Maps plugin for WordPress


This plugin provides 2 blocks.

  • MapPress Map
  • MapPress Maps for WordPress


See full installation intructions and Documentation
1. Install and activate the plugin through the ‘Plugins’ menu in WordPress
1. You should now see a MapPress meta box in in the ‘edit posts’ screen

Home Page


Please see the plugin documentation pages:

Home Page


27 красавіка, 2022
This plugin's free version provides what other map plugins are charging for. I love the backend user interface. I went with the Google API just because that's what I'm familiar with. My client wants to emphasize shipping destinations at points in the USA and around the world. And we needed a responsive map. Check. I'm very happy with this plugin. It works well with BeaverBuilder (but you need to use the Shortcode to embed a big deal) alongside GravityForms. No conflicts, very stable, and so easy to use my clients can update the maps themselves with just a little orientation. Great job!
6 снежня, 2021
Great plugin, very flexible and easy to use. It can give a "Obsolete jQuery version" error but usually you can just go into inspector and delete the error, and then you can edit the map anyway.
21 ліпеня, 2021
I have been using MapPress Maps for WordPress for years and it has made a tremendous difference on my website. People often say the best feature of the website is the maps! Whenever I have a question or issue, the developer is right there to help out. It is definitely the best plugin I have!
Read all 139 reviews

Contributors & Developers

“MapPress Maps for WordPress” is open source software. The following people have contributed to this plugin.


“MapPress Maps for WordPress” has been translated into 5 locales. Thank you to the translators for their contributions.

Translate “MapPress Maps for WordPress” into your language.

Interested in development?

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



  • Changed: allow popup to size larger when thumbnails are set to top, but no image is present
  • Fixed: missing scrollbars when popup content is large
  • Fixed: warning if default size selected in settings is invalid


  • Fixed: typo in setting ‘showCoverageOnHover’


  • Fixed: SVN publish


  • Fixed: remove generated iframe from build


  • Changed: enabled ‘check now’ button even when license is active


  • Fixed: mini map class not being applied to small maps
  • Fixed: other plugins break iframes by adding ‘defer’ to script tags


  • Changed: prevent WP from overwriting Pro with free version


  • Fixed: setting initialopeninfo with no map POIs causes JS error


  • Fixed: console warnings in Google marker clusterer from deprecated google.maps.addDomEventListener
  • Fixed: iframe not resizing when height is ‘vh’


  • Added: setting to allow mashup thumbnail images to come from either post or POI (mashupThumbs)
  • Added: fast iframes, and iframes that resize to inline (bottom) POI list layout
  • Changed: popups opened by marker hover now close after a short delay when mouse is moved away
  • Fixed: POI list not scrolling to top on page change


  • Changed: Google now returns viewport for street addresses, so poiZoom (default zoom) setting applies even if viewport is present
  • Fixed: map loses attachment if attached and then immediately edited


  • Fixed: syntax error in API for old versions of PHP (<7.3)


  • Changed: map minimum width changed from 250 to 200px
  • Changed: template editor split to separate module
  • Changed: post attachment control updated
  • Changed: REST API code added
  • Fixed: hideEmpty mashup parameter not compatible with new query functions


  • Changed: importer updated to allow upper-case column names
  • Changed: updated authors in mashup block to reflect new core data
  • Fixed: focus incorrect when creating new map and selecting title
  • Fixed: map not linked to post when creating new post
  • Fixed: refresh query button not working in mashup block


  • Fixed: mashup block shortcode viewer removed
  • Fixed: importer sample map selecting all POIs at once


  • Fixed: republish 2.83.6 changes


  • Fixed: map iframe interfering with theme customizer


  • Changed: workaround for other plugins loading obsolete versions of wp.element
  • Fixed: clicking on mashup thumbnail image not opening underlying post


  • Fixed: updated German translation
  • Fixed: double markers showing when using multiple maps with Leaflet clustering


  • Fixed: POI list pagination incorrect


  • Fixed: drag and drop error with Leaflet polyfill


  • Fixed: error from Leaflet json polyfill when theme overwrites Leaflet


  • Added: setting to disable Leaflet cluster outline polygons
  • Changed: editor maps switched to react
  • Fixed: directions not working for POIs with no address


  • Fixed: directions link not working


  • Fixed: markers shown outside clusters on initial load
  • Fixed: editor marker drag/drop not working


  • Fixed: zooming in and out on Google clusters could result in ‘null’ marker
  • Fixed: revert auto-sizing iframes; not compatible with viewport (‘vh’) sizing


  • Fixed: maps sized wrong when using sizes without units


  • Changed: frontend loader and rendering switched to react components
  • Changed: iframes resize to content


  • Changed: convert import/settings to react map


  • Fixed: url query parameter removed, some sites throw 403 error


  • Fixed: POI list showing extra POI beyond page size
  • Fixed: Map editor page size should not be controlled by front-end settings
  • Changed: begin React code transition for admin


  • Fixed: innodb utf8mb4 index on map title limited to 191 characters


  • Fixed: sorting not working in map list
  • Fixed: save button not disabled during map save
  • Fixed: trashed maps included in mashups


  • Fixed: array not initialized for custom props


  • Fixed: missing token description in template editor
  • Fixed: multiple custom fields not pulled into templates


  • Fixed: settings not saved in setup wizard


  • Added: trigger DB upgrade automatically


  • Fixed: maps not displaying when scripts output in footer


  • Added: enabled user maps


  • Changed: authorization ‘edit_posts’ is now used instead of ‘manage_options’ for the ‘maps’ menu
  • Changed: thumbnail images now specify size for better popup sizing


  • Fixed: POI list not selecting open POI
  • Fixed: mashup error when debugging enabled
  • Fixed: error when dismissing notices


  • Fixed: database upgrade check incorrect


  • Added: settings added for directions links in POI list
  • Changed: filters output even when closed, to allow custom CSS modification
  • Fixed: POIs filtered by map bounds even when search disabled


  • Fixed: thumbnail not positioned properly in popup modal
  • Fixed: template ‘default’ tab showing current template instead
  • Fixed: POIs were being filtered by bounds even when search disabled


  • Fixed: shapes not centering correctly when clicked
  • Fixed: not possible to enable POI hover and open POIs in a new tab or modal
  • Changed: added lazy loading and speed tests for iframes
  • Changed: deactivation screen updated


  • Fixed: ACF map fields not being read in mashups
  • Fixed: enable beta versions checkbox not working


  • Changed: source files renamed
  • Fixed: show filter options without escaping


  • Changed: updated query filters for WP 6.0
  • Fixed: adjusted infowindow sizing for sub-pixel rendering


  • Fixed: adjust webpack configuration to pick up missing translations


  • Fixed: mashup inline list not scrolling
  • Fixed: category filter include/exclude not working


  • Fixed: mashup list pagination not working


  • Fixed: directions link not working


  • Fixed: syntax error in mashups
  • Fixed: missing translation for pages
  • Fixed: list page size not working


  • Added: images can now be attached to POIs
  • Added: if multiple images exist, an image gallery is displayed in the map list and popups
  • Fixed: KML overlays were not displaying properly


  • Fixed: error when dragging Leaflet markers


  • Fixed: geocoding errors written to posts with no custom fields
  • Fixed: thumbnails not displaying properly in list
  • Fixed: insert not working for map sidebar panel


  • Fixed: maps with save center not displaying


  • Fixed: directions ‘to’ address blank


  • Changed: removed unused list templates
  • Fixed: missing POT translation for filter counts
  • Fixed: POI popup modal not working


  • Fixed: CSS preventing scrolling bottom POI list
  • Fixed: POI list not displaying in editor if disabled in settings
  • Fixed: blank map edit screen for some sites


  • Changed: completed removal of obsolete Algolia geocoder
  • Changed: updated JavaScript: map editor, POI editor, POI list, directions, map menu, map picker and settings
  • Changed: clustering libraries sourced from CDN


  • Fixed: removed import menu from free version
  • Fixed: removed french translation from plugin directory


  • Fixed: custom field geocoding not working


  • Fixed: option screen alignment wrong for some options
  • Fixed: travel line animation setting not saving properly


  • Added: option to connect POIs with lines, for travel blogs, etc. Lines can be enabled/disabled in the settings or with the shortcode: [mappress lines=”true”]
  • Added: new filters form using AJAX
  • Added: import screen for importing maps from CSV files
  • Changed: geocoding custom fields now use a datalist dropdown for easier entry
  • Fixed: Leaflet popup not centered when POI is opened from off-screen
  • Fixed: translations not available for JavaScript texts
  • Fixed: directions not opening when list is below map
  • Fixed: hovering highlight not removed
  • Fixed: on some servers compression settings prevented AJAX calls with output buffering enabled


  • Fixed: added back ability to programmatically specify center as array of (lat,lng)


  • Added: KML URL is now output when there is an error loading the KML file
  • Fixed: geocoder not recognizing some locations, including “lat,lng” entries


  • Fixed: autocomplete not creating new POIs


  • Changed: replaced JQuery Autocomplete with new search box


  • Fixed: check for wp-config settings preventing file changes


  • Fixed: check for wp-config settings preventing file changes


  • Fixed: inline directions input not working


  • Fixed: include/exclude not working for taxonomy filters


  • Fixed: notice on widget screen
  • Fixed: errors on beta theme editor screen
  • Changed: Remove jQuery version check and jQuery tabs control


  • Fixed: map doesn’t display if google directions used
  • Changed: filter CSS updated


  • Fixed: allow autoptimize to process scripts
  • Fixed: underscore functions and templates broken by woocommerce lodash


  • Fixed: notice in wp_query groupby


  • Fixed: exclude wp JS from autoptimize


  • Fixed: error resizing maps in jQuery tabs


  • Added: base code for mashups by users
  • Fixed: maps attached to a trashed post now appear in the map library
  • Fixed: template editor now inserts properly-formatted tokens for custom fields
  • Fixed: mashup query filtes could interfere with queries from POI oembeds


  • Fixed: PHP error when loading filters template


  • Fixed: possible PHP error on settings screen
  • Fixed: box-sizing added to layout CSS, directions made max width in mini view


  • Fixed: directions not displaying


  • Important: filters CSS has been updated, please update any custom filter forms to match
  • Added: better popup panning and sizing
  • Added: new custom JSON styles can be created in the style editor
  • Added: setting for filter position (search box or POI list)
  • Added: new filter editor in MapPress settings
  • Added: post count in filter dropdown
  • Added: new filter types: post type and text box
  • Added: user-defined labels for filters
  • Added: filter display formats (select/checkbox/radio)
  • Added: include or exclude specific terms (tags, categories,…) for filters
  • Fixed: filters size better in mini mode
  • Fixed: POI body not showing in Firefox when thumbnails on left/right
  • Fixed: control for attaching posts to maps now shows the correct custom post type
  • Fixed: mashup block not updating when query parameters change
  • Fixed: Gutenberg boolean attributes defaulting to false when converting classic blocks
  • Fixed: settings screen not displaying on some wordpress hosted sites


  • Fixed: list toggle not working


  • Fixed: directions link not working if no POI list present


  • Increment version


  • Changed: allow DOM events to bubble out of the map container


  • Fixed: POI drag and drop sorting not working in editor
  • Fixed: shortcodes in AJAX calls now include scripts with map/mashup output


  • Changed: mashup queries now use a single SQL statement, for hosts that limit SQL size
  • Fixed: youtube videos inside popups did not play full screen
  • Fixed: [mashup query=”current”] now displays current posts correctly


  • Added: option for POI list page size
  • Added: option for POI list open/closed when map is loaded
  • Fixed: directions not working on Android


  • Added: enable search for individual maps
  • Added: classic editor button updated for compatibility with Enfold theme
  • Changed: remove initialOpenDirections parameter
  • Changed: speed up Nominatim autocomplete
  • Changed: internal updates to ES6 JS for options and maps


  • Changed: clearer highlighting in map list
  • Changed: remove beta version
  • Changed: remove IE11 support


  • Added: maps can now be trashed or restored


  • Fixed: spinner prevented map panning


  • Added: improve license checking on settings screen


  • Added: snackbar notifications instead of dialog boxes
  • Added: new spinner


  • Fixed: automatic icons not showing in filters dropdown


  • Fixed: allow map display if some map containers are missing
  • Fixed: use default style if current style does not exist


  • Fixed: maps crash if center is set


  • Added: iframes now support inline lists, modal popup POIs, and alignment options
  • Changed: remove Algolia geocoder
  • Fixed: mashup search button hidden by GT editor
  • Fixed: KML POIs not working


  • Fixed: iframe does not display when height has no ‘px’ suffix


  • Changed: improved error reporting
  • Changed: improved setup wizard
  • Changed: ‘post types’ setting moved to geocoding section (it only applies to geocoding)
  • Fixed: disabled radio buttons not visible in settings


  • Added: console messages now display in map layout
  • Added: search/add button on search bar
  • Changed: default size changed to 100%/350px and fixed 425px/350px size removed
  • Changed: improved settings to prevent loading Google API twice
  • Fixed: make post date and post type available for mashup permalinks


  • Changed: expand styled maps availability


  • Fixed: custom icons missing white outline


  • Added: icon editor now supports Google Material Icons, foreground color, and font sizes
  • Added: icon editor now supports bulk delete
  • Added: icon file name can be edited


  • Fixed: error opening map editor when using classic editor and tinyMCE is disabled
  • Fixed: warning about block category in map library and classic editor


  • Fixed: error when saving some custom icons with no symbol
  • Fixed: ACF integration option not appearing in settings
  • Fixed: error preventing saving empty geocoding keys


  • Fixed: invalid image when when reverting to standard red pin icon


  • Fixed: error when using mashup query=”current”
  • Fixed: clustering max zoom not working for Leaflet when set to ‘none’


  • Fixed: unmounted component error from WP widgets screen unounting map
  • Fixed: warning about invalid block category on map library screen
  • Fixed: warning about toolbargroup vs toolbar
  • Fixed: empty mashup filters not saving, and warning about boolean count setting
  • Fixed: error from trimArray when saving settings


  • Fixed: error on settings screen


  • Added: ACF support for geocoding ACF map fields
  • Added: setting to include ACF map fields directly in mashups
  • Added: Leaflet scrollWheel setting to enable/disable mouse zooming on map
  • Added: settings to control sorting and term counts for mashup filters
  • Added: filter ‘mappress_filter_label’ to allow custom html for filter term labels
  • Changed: filter values displayed as flex; see mappress.css for info on changing to grid


  • Fixed: console error in theme customizer


  • Fixed: wrong mapid in Gutenberg sidebar


  • Added: MapPress can now read Advanced Custom Fields (ACF) map fields, for use with front-end maps
  • Fixed: insert map not working from Gutenberg sidebar


  • Fixed: error in 2.58 widgets screen


  • Added: Gutenberg sidebar document panel listing maps attached to current post/page


  • Added: settings for marker clustering, to control max zoon & spiderfy
  • Added: search bounding box
  • Added: warnings about geocoders, Algolia deprecation notice


  • Fixed: mashups not displaying if “compatibility” setting was active


  • Added: setting to display user location on mashup maps
  • Added: setting for mashup minimum search radius
  • Added: standard icons can now be overriden, just create an icon with the same name and any extension (gif/png/jpg)
  • Added: compatibility setting to output maps in iframes (and prevent theme/plugin compatibility issues)
  • Changed: mashup searches are now biased to viewport for all geocoders, not just Google
  • Changed: update filter dropdown CSS to use flexbox
  • Changed: add output class to term counts in filters dropdown
  • Changed: updated widgets for WP 5.8
  • Fixed: custom style json not saving


  • Changed: mashup filters now hide terms that are not assigned to any posts
  • Changed: update google marker clusterer to v.1.2
  • Fixed: missing logo


  • Fixed: JS libraries were not compiled properly


  • Added: welcome guide and support page
  • Fixed: post modal content not shown for logged-out users


  • Fixed: unable to save default custom style


  • Fixed: missing POIs in list
  • Changed: menu removed for Leaflet maps
  • Changed: deactivation form updated


  • Added: new map control and modal for editing custom map styles
  • Added: new templates for map list items – please update custom templates to match
  • Added: filters now support multiple filter taxonomies
  • Added: POI list now has pagination controls
  • Fixed: icon scale of 0 should be blank (auto scale)


  • Fixed: popup text not sizing to featured image
  • Fixed: directions server and POI body settings not saving properly
  • Fixed: mapbox default style not applying for maps saved without a map type
  • Changed: updated filters ‘mappress_post_query’ and ‘mappress_pre_filter’


  • Fixed: mapbox style preview URL not working
  • Added: workaround for Jetpack Infinite Scroll bug that prevents inline scripts


  • Fixed: default POI zoom setting not saving


  • Changed: pagination moved to map list toolbar
  • Fixed: compatibility fix for autoptimize


  • Added: map list is now paged
  • Fixed: enter key in classic editor title not publishing post
  • Fixed: opening map library slow because of ‘attach’ control
  • Fixed: blank settings screen for missing icons widget


  • Fixed: Infobox mouse event bleeding through to map
  • Fixed: Mapbox geocoder not setting POI title for new POIs
  • Fixed: POI list position setting not working
  • Fixed: custom Google styles saving with extra slashes
  • Added: better CSS styling for custom map styles table in MapPress settings screen


  • Fixed: alert for missing drawing API


  • Fixed: error with missing layout option for sites upgrading from old versions


  • Fixed: error in geolocate control for non-SSL sites using Leaflet
  • Fixed: error when opening Mapbox style settings
  • Fixed: some themes hide centered maps with opacity:0


  • Added: Gutenberg map/mashup blocks now support ‘wide’ and ‘full’ alignment
  • Added: Gutenberg map/mashup blocks should now better support ‘left’, ‘right’ and ‘center’ alignement
  • Added: A new ‘your location’ geolocation control has been added over the map +/- zoom controls
  • Removed: the ‘your location’ control has been removed from the search box
  • Changed: POI list is now enabled by default


  • Fixed: settings screen not displayed in free version


  • Fixed: infobox anchor incorrect if icon scale is empty
  • Fixed: license check button JS error


  • Added: POI click settings for mashups now include showing the entire post in a full-screen popup
  • Changed: POI list widened to 300px
  • Fixed: hover effect not deselecting when new POI hovered
  • Fixed: error in infobox when POI opened on hover and map hasn’t initialized yet


  • Added: new icon generator to create icons dynamically
  • Added: new color picker
  • Added: new icon picker


  • Fixed: error “class Mappress_Pro_Settings not found”


  • Added: default sizes are now responsive (%) based, pixel and viewport sizes are still supported
  • Added: default sizes are now editable and sortable
  • Added: new settings have been added for users of the free version
  • Added: support for the new block-based widget editor
  • Changed: plugin setttings screen is now React-based
  • Changed: POI editor icon picker and color picker have been converted to React
  • Fixed: POI list not updating when POI is changed
  • Fixed: conflict with Yoast preview slug temporarily appearing blank
  • Fixed: Gutenberg editor setting map alignment on settings screen prevents blocks from being selected
  • Fixed: React error for duplicate keys in multiselect


  • Added: updated flex-based mashup list & popup templates with better thumbnail support – please update any custom template
  • Added: updated map popup template and CSS – please update any custom templates
  • Added: for classic editor: put the cursor on a shortcode to open that map in editor
  • Added: better infobox panning and sizing
  • Added: mashup thumbnail position can now be set in MapPress settings
  • Added: setting to open POIs on mouse hover
  • Added: map library now supports column sorting by mapid, map title, and post title
  • Added: window.location is now passed as argument ($args->url) to filter ‘mappress_pre_query’
  • Added: classic editor is now React-based


  • Fixed: JS files were not compiling for IE11. Note that IE11 is NOT a supported browser.
  • Fixed: Leaflet icons were not setting scale properly, interfering with marker spiderfier
  • Fixed: error when saving map center of 0,0
  • Added: new marker class to enable effects
  • Added: map data can be recovered after deletion
  • Added: highlighting on mouse over for list and marker hover
  • Added: better z-indexing for hovered marker


  • Added: selected icon can now be highlighted with a special icon or a circle
  • Fixed: error preventing KML files from being added to map


  • Fixed: jQuery warning was causing maps to not display in older WP versions


  • Fixed: places strim trim() not working for maps with center specified by lat/lng
  • Fixed: better error message for sites with obsolete jQuery and jQuery UI
  • Fixed: admin notices not showing correctly on settings page
  • Fixed: added warning for expired license
  • Fixed: errors for invalid KML files were not displaying


  • Added: new infobox with better panning and sizing
  • Added: infobox can now be used with Leaflet, in addition to Google
  • Added: standard Leaflet popups now fit to the map dimensions
  • Added: oembed has been enabled for popups, POIs can now include Youtube videos, music, etc
  • Added: maps can be attached/detached from posts in the map list and map library
  • Added: query by specific post IDs added for Gutenberg mashup blocks
  • Added: map type (style) added to the settings for Gutenberg mashup blocks
  • Added: filter ‘mappress_poi_excerpt’ can be used to control excerpts in map POIs
  • Changed: bigger popups for POI editor
  • Fixed: warning message for mashup widget in new widget editor
  • Fixed: Gutenberg plugin caused blank taxonomy names in mashup blocks


  • Fixed: remove extra translation json file


  • Fixed: language texts were not being picked up for JavaScript texts


  • Added: new map editor for WordPress Classic editor
  • Added: ‘add media’ button in map POI editor opens WordPress media library to insert images, etc. into POIs
  • Added: enabled POI list toggle in editors
  • Changed: leaflet popups can now size larger and not overflow the map area
  • Changed: editor popups are now larger
  • Changed: better positioning of popup pointer over map markers


  • Changed: move WPML settings to free version


  • Added: when using the WPML language plugin, maps are copied when duplicating a post from the original language


  • Changed: Google infoBox popups resize better to fit large content
  • Changed: exclude MapPress from Autoptmize to prevent “wp is not defined” errors in WordPress i18n scripts


  • Fixed: mashup markers linking to home page instead of individual posts


  • Changed: CSS improvements in map library
  • Changed: Nominatim PHP gecodoer now sleeps for 1 sec to comply with their usage limits
  • Changed: improved Nominatim address title parsing


  • Fixed: typo in initial open directions


  • Fixed: fixed version incompatibility in plugin header


  • Changed: enabled Gutenberg blocks for blogs that did not use beta versions


  • Fixed: directions form not working
  • Fixed: fatal error for missing icon upload


  • Changed: map font color set to black
  • Fixed: Next Gen Gallery plugin interferes with template output


  • Added: refresh button for Gutenberg mashup block
  • Added: workaround for Gutenberg ‘additional classes’ bug (
  • Fixed: POI title was not set for POIs added using Nominatim geocoder
  • Fixed: autocomplete CSS styles are not applied
  • Fixed: Remove console log message


  • Release beta changes from 2.55


  • Added: map library, available in the MapPress settings
  • Changed: map ‘picker’ dialog now saves scroll position


  • Added: Gutenberg map and mashup blocks added
  • Added: mini mode setting (width at which the left POI list is collapsed)


  • Added: clustering is now supported, enable it in the MapPress settings screen
  • added: maps with POI list on the left go into ‘mini’ mode when small: list is hidden and buttons can be used to toggle map or list
  • Added: custom icons can now be uploaded directly in the MapPress settings screen
  • Added: a new widget is available to display a single map, in addition to the mashup widget
  • Added: .jpg icons are now supported in addition to .png and .gif
  • Added: mashup filters dropdown includes post counts for each term
  • Added: filter ‘mappress_options’ allows global options to be changed before maps are displayed
  • Added: mashup queries now only read post title and body if ‘POI content’ setting is set to ‘Post title + post excerpt’
  • Added: new PHP filters are available for mashup queries: mappress_pre_filter($filters), mappress_pre_query($query) and mappress_post_query($map)
  • Changed: algolia autocomplete has been removed and replaced with jquery autocomplete
  • Changed: because of data discrepancies, algolia places no longer provides autocomplete results for Nominatim/Mapbox geocoders
  • Changed: Nominatim/Mapquest autocomplete requests will affect quotas with those services, only Algolia is “free”
  • Changed: for the ‘left’ map layout, directions are displayed in the sidebar like the POI list
  • Changed: mashups with blank query now show ALL posts: [mashup] is now equivalent to [mashup query=”all”]
  • Changed: to show current posts, use [mashup query=”current”] instead of leaving query blank
  • Changed: PHP templates have been converted to JavaScript templates (for example, file ‘map.php’)
  • Changed: mashup filter CSS has been converted to a grid layout
  • Changed: Leaflet updated to version 1.7.1
  • Changed: JS map ‘close’ and ‘open’ methods changed to ‘poiOpen’ and ‘poiClose’
  • Changed: like Google, the Leaflet API is now downloaded from CDN rather than the plugin directory
  • Changed: action ‘mappress_map_save’ receives entire $map object, not just $mapid
  • Fixed: some geocoders were not properly using the country/language parameters
  • Fixed: color picker not positioning correctly when opened
  • Fixed: popup not positioning correctly when opened


  • Changed: additional CSS changes to migrate layout to flex
  • Changed: map font switched to sans-serif (overriding theme – change mappress.css if needed)
  • Fixed: warning in settings when switching map engine type
  • Fixed: warning in PHP log when displaying empty mashups
  • Fixed: mashup sometimes deselected current POI in list for small maps


  • Added: curly braces can now be used in mashup queries to pass array parameters
  • Changed: map layout switched to CSS flex
  • Fixed: exclude mashup shortcodes from Gutenberg REST requests


  • Added: ‘dragging’ and ‘keyboard’ shortcode attributes for Leaflet maps
  • Fixed: map shortcode not working in archive text widget
  • Fixed: a few themes/plugins trigger wp_footer too early, preventing templates from loading before scripts


  • Changed: removed space in version string because of conflict with some CDNs
  • Changed: editor made slightly (25px) taller
  • Changed: restored mashup option to open post in same tab
  • Changed: internal changes to remove correctedAddress property


  • Fixed: custom styles stopped working after MapBox URL change
  • Fixed: updated line unused method for PHP 7.2 compatibility checker


  • Changed: minor internal updates to geocoders
  • Fixed: centering not working on maps from old versions of plugin


  • Added: Algolia, Nominatim and MapBox geocoders can be selected on MapPress settings screen
  • Changed: updated Algolia Places to latest version
  • Changed: updated Leaflet to 1.4.0
  • Fixed: added missing left float for mashup thumbnails (to modify it, see ‘.mapp-body .wp-post-image’ in mappress.css)
  • Fixed: dead directions link if setting ‘none’ was imported from prior versions


  • Added: setting to display KML POIs in mashup maps
  • Fixed: conflict with 2017 theme and Leaflet zoom buttons
  • Fixed: maps output in Gutenberg REST requests when option to load scripts in header is selected


  • Added: a ‘check now’ button has been added to the settings screen to force license check
  • Fixed: priority was too high for default ‘mappress_poi_props’ filter


  • Added: geocoding errors are now shown on the settings screen


  • Fixed: map controls language code not saving/displaying correctly


  • Fixed: ajax error when opening map for edit


  • Fixed: prevent enter press in map list search from publishing post
  • Changed: updated map editor search/filter function
  • Changed: internal function Mappress::ssl() renamed Mappress::is_ssl() – please update any custom directions.php or search.php to use the new name


  • Added: mashups with a center but no zoom will perform a radius search
  • Fixed: KML markers showing POI text instead of text from KML file
  • Fixed: mashup initial center and zoom have been improved
  • Fixed: mashups not displaying on some servers; updated gzip detection
  • Changed: internal mashup query and layers control changes


  • Fixed: PHP 7.2 notice on widgets_init
  • Fixed: blank map when initial centering for mashups using Google engine


  • Added: support for high-resolution MapBox tiles on high DPI (retina) devices
  • Changed: mashups with multiple POIs will now honor shortcode zoom
  • Changed: Leaflet updated to 1.3.4
  • Fixed: notice on multisite settings screen when user is not super-admin


  • Added: dropdowns for language/country codes
  • Fixed: blank map occurs if other plugins trigger window resize before map is initialized
  • Fixed: only print mashup templates in Pro version
  • Fixed: continue execution if map container is missing


  • Fixed: Google maps not displaying in editor when no styles defined


  • Fixed: search toolbar not hidden when editing map


  • Fixed: 2nd style bug preventing map display


  • Fixed: bug in styles could prevent map from displaying


  • Added: Mapbox token can be set in wp-config.php for multisite with: define(‘MAPPRESS_APIKEY_MAPBOX’)
  • Fixed: editor now shows ALL results when searching for maps
  • Fixed: Google styles were not being applied


  • Added: easy entry of Mapbox Studio style names in the MapPress settings screen
  • Fixed: custom styles are now retained when switching engines
  • Fixed: initialopeninfo parameter was not working for Leaflet maps
  • Fixed: better CSS for search box in firefox


  • Fixed: updater was not correctly checking major versions, e.g. 2.50 vs 2.50.1


  • Added: updated editor map list in the map editor now allows searching across all posts
  • Fixed: POI list was not refreshing when filtering in some installations


  • Added: error message when places API not loaded
  • Added: enter points into map editor as “lat,lng”
  • Changed: mashups should now show all POIs
  • Changed: mashups with a single POI will honor shortcode zoom
  • Fixed: map not resizing when a tab is displayed


  • Added: filters to set MapBox studio styles and custom map tiles
  • Changed: mapping engine now defaults to leaflet
  • Fixed: removed links pointing to beta documentation
  • Fixed: KML popup could appear multiple times when editing multiple maps
  • Fixed: unable to drag markers in editor when using Leaflet


  • Fixed: autocomplete conflict with WordPress tag search fields

2.49.5 BETA

  • Fixed: missing leaflet layer control images

2.49.4 BETA

  • Fixed: incorrect documentation URLs

2.49.3 BETA

  • Fixed: missing files for algolia/leaflet in build version

2.49.2 BETA

  • Fixed: bug preventing new POIs using Google engine
  • Fixed: mashup POI list not refreshing on first zoom/pan (Google)
  • Fixed: map dialog appearing under ‘hamburger’ menu
  • Fixed: removed ‘mapp-static’ class
  • Fixed: notice on some sites during settings save
  • Fixed: duplicate texts in .POT translation file

2.49.1 BETA

  • Fixed: mashups were using the map-popup and map-item templates instead of mashup-popup and mashup-item
  • Fixed: removed extra ‘mapp-iw’ tags from popup templates
  • Fixed: javascript error when centering on invalid place (leaflet only)
  • Fixed: removed CSS min-width for leaflet popup
  • Fixed: notice in admin plugins search screen (updater was not setting ‘plugin’ field in version response)
  • Fixed: error for leaflet KML layers (setZindexOffset)
  • Fixed: maximum mashup POIs was locked at 5

2.49 BETA

  • Added: support added for Leaflet, MapBox, and Algolia search
  • Added: mashups are now searchable – see the search options on the MapPress settings screen
  • Added: client-side templating system and template editor on MapPress settings screen
  • Changed: filter fields now output more data (type, meta_type, etc)
  • Changed: the ‘mini’ map mode (with list/map toggles) has been temporarily removed
  • Changed: Pro updater is now available by default


  • Fixed: restored inline directions form
  • Changed: updated ‘directions.php’ template file and CSS
  • Changed: updated plugin with new URL
  • Changed: re-added use of inline script functions for themes that match tags inside content (json) data


  • Fixed: geocoding bug in editor
  • Removed: drawingmanager


  • Fixed: shake in editor caused by Google API update
  • Fixed: API compatibility setting not applied in admin screens
  • Changed: removed inline directions, shape editor


  • Added: maps now support full-screen control: [mappress fullscreenControl=”true”]
  • Fixed: map center was changing when resizing
  • Fixed: mashups were ignoring custom POI list template
  • Changed: mashup filter now shows term names instead of term slugs


  • Added: dismissible notices
  • Fixed: incorrect sorting for mashups with ‘orderby’ clause in query
  • Fixed: incorrect CSS in settings screen
  • Changed: use gzip only for mashups, not for maps, added checks for PHP libraries


  • Fixed: POI list was being hidden on small maps with ‘inline’ vertical layout
  • Fixed: empty ‘ghost’ link if post thumbnail is absent


  • Updated version number


  • Updated version number


  • Fixed: centering error for fixed centers


  • Fixed: PHP 7 error on ‘break’ statement


  • Fixed: bug in free version prevented editing


  • Fixed: internal javascript error


  • Added: prevent javascript caching when upgrading from free to Pro
  • Added: enable gzip compression for AJAX data (depends on server settings)
  • Added: ‘compatibility’ setting to prevent loading maps API by other plugins/themes
  • Added: new layout with POIs on left. Use settings or [mashup layout=”left”] for a single map
  • Added: shortcode ‘center’ can be a place or ‘user’ to geolocate, for example: [mashup center=”new york”] or [mashup center=”user”]
  • Changed: mashup query updated to improve performance
  • Changed: faster excerpts for mashup POIs
  • Changed: Pro update settings are now enabled by default
  • Changed: automatic centering zooms out less whenever possible (viewport padding reduced to zero)
  • Changed: clickableIcons defaulted to false (prevent clicks on Google landmarks)
  • Changed: removed extra code for xhtml validity checkers
  • Changed: updates to directions and template ‘map-directions.php’
  • Changed: detection for Jetpack infinite scroll improved


  • Added: filter labels can now include an icon in braces, for example [blue-dot]
  • Added: filter ‘mappress_query_filter’ for post-query filtering
  • Fixed: workaround for older versions of WordPress which have error in underscore library


  • Added: setting to open POIs in a new tab/window. For shortcodes use [mashup mashupClick=”postnew”]
  • Fixed: mashups for custom post types were displaying all post types
  • Fixed: maps saved from custom fields in older versions were not auto-centering properly


  • Fixed: Pro version updater bug fixes


  • Fixed: Pro version automatic updater was not notifying about new updates (it may be necessary to update to the current version manually).


  • Changed: the settings for mashup POI title and body display have been combined. Select either poi title + body or post title + excerpt. For shortcodes use [mashup mashupbody=”poi”] for poi title + body, or [mashup mashupbody=”post”] for post title + excerpt


  • Added: filter dropdown now includes icons from the ‘automatic icons’ setting (for use as a map legend)
  • Fixed: editor spawner multiple icon color pickers, so popups were sometimes in the wrong position
  • Changed: ‘directions’ and ‘mashupClick’ (POI click behavior for mashups) are now global, set them from the settings screen instead of the shortcode
  • Changed: templates ‘map.php’ and ‘map-list.php’ were updated, please update any custom templates
  • Changed: list CSS class ‘mapp-pois’/’mapp-poi’ were changed to ‘mapp-items’/’mapp-item’


  • Changed: pro updater cache name changed to ‘mappress_updater_[action]’


  • Fixed: POI editor error if tinyMCE is disabled in user settings


  • Fixed: default style not being applied
  • Fixed: infoWindow displaying even when type = ‘none’


  • Fixed: maps in Jquery tabs control not automatically resizing


  • Fixed: sorting in editor not working after first re-sort


  • Fixed: javascript error on settings screen
  • Fixed: improved check for multiple API keys
  • Fixed: custom template not applied for mashup POIs


  • Fixed: mashup poilist not shown if shortcode enabled and global setting disabled
  • Fixed: default map style not always applied


  • Fixed: editor not loading properly in 2.46.2
  • Fixed: minZoom not working in shortcodes


  • Fixed: Pro version automatic updater communications errors
  • Fixed: icon picker was not working on MapPress settings page


  • Added: updated French translation, thank you to Serge
  • Fixed: directions were showing ‘null’ if empty


  • Added: NEW TEMPLATES – this release includes all new template files – please update any custom templates to match the new versions.
  • Added: mashup results can now be filtered by taxonomies, see the MapPress settings screen
  • Added: setting ‘Automatic updates’ allows automatic updates for the Pro version
  • Added: new layout with POIs on the left instead of under map, enable with: [mappresss layout=”left”]
  • Added: check for multiple Google Maps API loads
  • Changed: template names now use hyphens instead of underscores and some names have changed: map_layout.php => map.php, map_poi_list.php => map-list.php
  • Changed: CSS class names, for example for the POI list class ‘.mapp-poi-list’ is now ‘.mapp-list’. Please update any custom CSS.
  • Changed: use the ‘hamburger’ menu in the map editor to set a map’s center & zoom (previously a checkbox was shown in the map editor)
  • Changed: mashups now ignore any center/zoom settings and automatically center to show all POIs
  • Changed: directions now have a Google Maps link. Transportation modes have been removed
  • Changed: ‘my location’ shown only for SSL or localhost sites (Google has forbidden geolocation on non-secure sites)
  • Changed: maps automatically recenter on screen resize (previously this was the ‘adaptive’ setting)
  • Changed: scripts are now loaded in the header if JetPack Infinite Scroll is enabled


  • Fixed: default custom style not applied when displaying map


  • Fixed: bug when saving quotes (such as image tags) in POI body
  • Fixed: custom map styles not displayed properly


  • Removed: directions settings ‘from’ and ‘to’
  • Removed: ‘adaptive’ setting


  • Fixed: maps were not saving attributes correctly including title, size and map type
  • Fixed: maps with one POI were not setting zoom correctly
  • Fixed: setting for default poi zoom was not saving
  • Fixed: setting for POI click (‘mashupClick’) was ignored if used in shortcode
  • Changed: directions ‘to’ is added by default for all POIs
  • Removed: setting for no directions (directions=”none”)
  • Removed: POI links (‘poiLinks’) setting removed


  • Added: a new checkbox in the map editor allows you to choose whether to save the center and zoom. If unchecked, the map will auto-center when displayed.
  • Added: POI list sorting can now be set via the settings screen, the default is no sort
  • Added: POI list can now be clicked anywhere to select a POI (not just the POI title)
  • Added: a new ‘hamburger’ menu on the map provides map functions including centering and the bicycling, traffic, and transit layers
  • Added: a new ‘layers’ shortcode attribute enables bicycling/transit/traffic layers when map is initially displayed, for example [mappress layers=”bicycling”]
  • Changed: autoicons function simplified: only 1 rule type is allowed, unfortunately you must re-enter any existing autoicons settings.
  • Changed: mashup settings are now global including infowindow type (‘iwtype’), POI body (‘mashupBody’), and POI title (‘mashupTtitle’) – use the settings screen to set them, NOT the shortcode
  • Changed: obsolete map control settings have been removed, and settings have been simplified to match Google defaults
  • Changed: when centering a map, if the map has a saved center/zoom the viewport will be reset to that center/zoom, otherwise it will autocenter
  • Changed: the ‘initialopeninfo’ shortcode attribute now accepts only true or false, not a POI index
  • Changed: POI ‘directions’ links have been removed from the POI list (but still show in the POIs). This allows display of more POIs in the list.
  • Removed: mashup link (‘mashuplink’) setting, POI titles now always link to underlying post in mashups
  • Removed: settings ‘draggable’, ‘keyboardshortcuts’, ‘maptypecontrol’, ‘maptypecontrolstyle’, ‘maptypeids’, ‘overviewmapcontrol’, ‘overviewmapcontrolopened’, ‘pancontrol’, ‘rotatecontrol’, ‘scalecontrol’, ‘scrollwheel’, ‘streetviewcontrol’, ’tilt’,’tooltips’,’zoomcontrol’, ‘zoomcontrolstyle’
  • Removed: settings ‘template’, ‘templatedirections’, ‘templatepoi’, ‘templatepoilist’
  • Removed: settings ‘bicycling’, ‘traffic’, ‘transit’, ‘initialBicycling’, ‘initialTraffic’, ‘initialTransit’
  • Removed: ‘bigger map’ and POI ‘zoom’ functions
  • Removed: the ‘mapLinks’ setting is removed (these functions have been replaced by the new map menu)