Modern Maps
Download free ↓
Guides

Your first map: a 60-second walkthrough.

Jake ◉ MAY 3, 2026 05 MIN

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.

This post is the version where that does not happen. We are going to install Modern Maps, drop a block onto a page, search a location, and publish a working map. The whole thing takes about a minute. We will time it.

Install

Two paths to installed-and-active, both fast.

1. Download from modernmapswp.com — the path we’d recommend, because it ships with the in-plugin Pro upgrade option built in. Grab the latest zip:

https://updates.modernmapswp.com/modern-maps-pro/modern-maps-pro.zip

In your WordPress dashboard, open Plugins → Add New → Upload Plugin, choose the zip you just downloaded, click Install Now, then Activate. That is the entire installation step. No setup wizard fires. No “before you continue” modal asks you to register an account or paste an API key.

2. WP-CLI does the same in one line:

# one line, no flags, no follow-up prompts
wp plugin install https://updates.modernmapswp.com/modern-maps-pro/modern-maps-pro.zip --activate

A quick word about what just happened, because it is unusual. Most map plugins activate into a half-built state — installed but unable to render a map until you wire them to a tile provider. Modern Maps ships its own tile delivery, served from our edge network. Activation is the whole setup.

If you’d rather install through the WordPress dashboard, search the plugin directory for Modern Maps Lite. Same map, no in-plugin upgrade prompts — when you eventually want Pro, you’ll switch to the marketing-site download to apply the license.

Alternative install path

Add the block

Open any post or page in the block editor. Type /map and hit return. A map block lands in the content with a default view.

Fig. 1 · The block in its default state, dropped onto a page and centered on Paris · ◉ 48.8566° N, 2.3522° E

Out of the box you get the following, none of which you have to opt into:

  • A vector basemap rendered through MapLibre GL
  • The Standard preset — one of three free styles, with Light and Dark as the other two
  • Theme sync — pick from any color in your active Gutenberg theme palette and the entire map updates to match
  • A pin you can drag to refine the location
  • Pan and zoom controls
  • Sensible defaults for height, padding, and zoom

Click anywhere on the map to drop a different pin. Drag to recenter. The block updates live in the editor — no preview tab needed.

Search and publish

Open the block sidebar (the right panel). The first field is Location. Type the place you want to show — a street address, a neighborhood, a country, a coordinate pair — and hit return.

The map flies to your location and drops a pin. Adjust the zoom if you like, or leave it at the default of 12. Twelve is the level where you can see a neighborhood without losing context — high enough to make the place feel specific, low enough that a single pin doesn’t get lost.

When the map looks right, click Publish. The page is live, and the map renders identically on the front-end of your site to what you saw in the editor. Refresh the page on your phone to confirm.

Sixty seconds, three steps, one map. The plugin spends its complexity budget on the things you would have noticed — not on the things you would have had to set up first.

The pitch, in one sentence

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, the things you might want to try next are all in the same block sidebar:

  • The other two presets — try Light for a clean, minimal feel, or Dark for a deeper base. Each preset re-skins the entire map.
  • Theme sync controls — pick which Gutenberg theme color the map should sync to, or override it with a custom hex.
  • 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.

If you outgrow the three free presets, Pro unlocks in-plugin via license key — no reinstall, no plugin swap. It currently adds:

  • LCH color controls — fine-tune hue, chroma, and lightness independently, on every map layer
  • Additional curated presets — more starting points, designed to drop straight in
  • Multi-site licensing — five or twenty-five sites per license, depending on tier
  • Priority email support — direct line, skips the WordPress.org public forum

Sixty seconds. Done.

Jake