Your first map: a 60-second walkthrough.
You’ve installed plugins before. You know how this normally goes. You search the directory, install the thing, activate it, and then spend forty-five minutes wading through a setup wizard that asks for credentials you do not yet have.
Install Modern Maps free, add a Modern Maps block, then add markers and popups in the WordPress block editor.
This guide uses the free Modern Maps plugin. If you are not yet sure it is the right method for your site, start with how to add a map in WordPress, which lays out all four and points you at one.
Install
Install the free Modern Maps plugin from WordPress.org or with WP-CLI.
1. WordPress plugin directory. Open Plugins → Add New Plugin and search for Modern Maps. Use the plugin from this listing:
Click Install Now, then Activate. You do not need a paid license for maps, markers, or popups in Modern Maps.
2. WP-CLI. Install and activate the same free plugin by its directory slug:
# free Modern Maps plugin from WordPress.org wp plugin install modernmaps-lite --activate
The public product name is Modern Maps. The WordPress.org directory slug remains modernmaps-lite.
The free Modern Maps plugin provides maps, markers, and popups. You do not need Modern Maps Pro to follow this guide.
Free plugin
Add the block
Open a post or page in the block editor. Search for Modern Maps in the block inserter and add the Modern Maps block.
The free plugin includes:
- A vector basemap rendered through MapLibre GL
- Three map style presets
- A theme color picker for your map
- Map Marker blocks for your locations
- Pan and zoom controls
- Sensible defaults for height, padding, and zoom
Add a Map Marker inside the Modern Maps block. Add text, images, or other blocks inside Marker Popup.
Search and publish
Select a Map Marker and use Search Address under Location Settings in the block sidebar to find the place you want to show.
Check the marker’s position and adjust the map view to suit your locations.
Preview the page and check your markers, popups, and links. Publish when it looks right, then check the live page on desktop and mobile.
Install Modern Maps, add a Modern Maps block, then add your markers and popups.
The free setup
What you did not have to do
This is the part of the post where most installation guides get long. Here is what you skipped:
- You did not visit the Google Cloud Console. There was no project to create, no billing account to link, no API to enable.
- You did not generate an API key, and therefore did not have to figure out how to scope it, restrict it, or rotate it later.
- You did not paste a client ID and secret into a settings page. There is no settings page that asks for them.
- You did not install a second plugin to handle authentication, caching, or tile delivery.
- You did not set up a billing alert to make sure your site does not get charged for a viral pageview.
- You did not edit your
wp-config.php, your.htaccess, or any environment variable.
If any of those steps sound familiar, they are familiar because the dominant map plugin for WordPress treats your site as a thin client for Google Maps Platform. Modern Maps is the version that does not.
What is next
Once you have your first map on the page, try these free controls:
- Map style presets: compare the three styles and choose one for your page.
- Theme color: choose a color for your map.
- Marker popups: add a marker to the map, then drop any block (paragraph, image, button) inside its popup.
- Border, radius, and shadow: standard Gutenberg block controls work on the map exactly like they work on an image.
For paid options, See paid plans. The currently available Modern Maps Pro 0.1.8 is a separate, standalone plugin. A license does not add paid controls to maps made with the free Modern Maps plugin. Its paid features include:
- LCH color controls: fine-tune hue, chroma, and lightness independently, on every map layer
- Unlimited markers in licensed Modern Maps Pro 0.1.8. The free Modern Maps plugin also has no two-marker cap.
- Multi-site licensing: five or twenty-five sites per license, depending on tier
- Priority email support: direct line, skips the WordPress.org public forum
Already have a Modern Maps Pro license? Contact support for your current download and setup; you do not need to buy again.