Installation & Setup
How to install WP Maps and set up your API keys.
Last updated
How to install WP Maps and set up your API keys.
Install WP Maps like any other WordPress plugin. You can:
Search for Mapster WP Maps in your WordPress admin under Plugins > Add New, or
Download the zip from WordPress.org and upload it via Plugins > Add New > Upload Plugin
Once activated, you'll see a Maps item in your WordPress admin menu.
WP Maps works out of the box with MapLibre — no API key needed. If you want to use Mapbox or Google Maps, you'll need to supply your own API key.
To use Mapbox GL JS, you'll need a Mapbox access token. Get one at mapbox.com — Mapbox offers a generous free tier.
Once you have your token, add it under Maps > Settings > Mapbox Access Token. You can also enter it on a per-map basis in the Mapmaker if you don't want a global default.
Note: Certain controls — like the Geocoder and Directions — also require a Mapbox token even if you're using MapLibre. If you plan to use those controls, you'll need to add a token.
To use Google Maps, you'll need a Google Maps API key with the Maps JavaScript API enabled. You can create one in the Google Cloud Console.
Add your key under Maps > Settings > Google Maps API Key.
Note: Some Google Maps features (like the Geocoder) require additional APIs to be enabled on your key, such as the Places API or Directions API. Google will surface an error in the browser console if a required API isn't enabled.
If you have a WP Maps Pro license, activate it under Maps > Settings > License. This unlocks Pro-only features, which are marked throughout these docs with a Pro badge.
[SCREENSHOT: Settings screen showing token fields and license input]
Last updated