> 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/overview.md).

# Overview

**Mapster WP Maps** is a WordPress plugin for building interactive, fully customizable maps — directly from your WordPress admin. No coding required to get started, with extensive developer tools available when you need them.

## How It Works

WP Maps has three layers that work together:

1. **The Mapmaker** — a visual map editor that lives in your WordPress admin. This is where you configure everything: add features, style them, set up controls, and manage how your map looks and behaves.
2. **The WordPress Plugin** — handles storing your map configuration, serving it to the frontend, and providing the shortcode you use to embed maps on any page or post.
3. **The SDK** — a JavaScript library that runs in your visitors' browsers and renders the actual map using the mapping library of your choice.

As a regular user, you'll mostly be working inside the Mapmaker. The plugin and SDK handle everything else automatically.

## Map Libraries

WP Maps supports three mapping libraries, each with different strengths:

| Library          | API Key Required | Best For                                                  |
| ---------------- | ---------------- | --------------------------------------------------------- |
| **MapLibre**     | No               | Free, open-source maps with no usage limits               |
| **Mapbox GL JS** | Yes              | High-quality styles, advanced features, satellite imagery |
| **Google Maps**  | Yes              | Familiarity, Street View, Google-native styling           |

You choose your library when creating or editing a map. Most features work across all three — any exceptions are noted in the relevant section.

> **Tip:** If you're just getting started or don't need a specific mapping style, MapLibre is a great choice — it requires no API key and has no usage limits.

## What's New in V2

V2 is a significant rewrite focused on a better editing experience:

* **New visual Mapmaker** — replaces the old ACF-based editor with a purpose-built, real-time map editor. Changes preview live as you make them.
* **Unified editing interface** — map settings, features, controls, and styles are all managed in one place.
* **Improved developer API** — the old hooks system has been replaced with an event-based SDK. See the [Developer](/mapster-wp-maps-v2/developer/sdk-overview.md) section for details.
* **Same core functionality** — all the features you know from V1 are still here. Only the interface has changed.

If you're upgrading from V1, see [Upgrading from V1](/mapster-wp-maps-v2/getting-started/upgrading-from-v1.md).