> For the complete documentation index, see [llms.txt](https://wpmaps-docs.mapster.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wpmaps-docs.mapster.me/mapster-wp-maps-v2/getting-started/installation.md).

# Installation & Setup

## Installing the Plugin

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](https://wordpress.org/plugins/mapster-wp-maps/) and upload it via **Plugins > Add New > Upload Plugin**

Once activated, you'll see a **Maps** item in your WordPress admin menu.

## API Keys

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.

### Mapbox

To use Mapbox GL JS, you'll need a Mapbox access token. Get one at [mapbox.com](https://account.mapbox.com/auth/signup/) — 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.

### Google Maps

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](https://console.cloud.google.com/).

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.

## Pro License

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]