> 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/upgrading-from-v1.md).

# Upgrading from V1

## The Short Version

For most users, upgrading is automatic. Install V2 over your existing plugin and everything carries over — your maps, features, and settings are untouched.

If anything looks off after upgrading, we're here to help. Reach out at [mapster.me/contact](https://mapster.me/contact) and we'll get you sorted.

## What's Changed

The main change in V2 is the editing interface. Maps are now configured in the **Mapmaker** — a new visual editor — rather than the old ACF-based post editor. Your existing map data is fully compatible; you'll just be editing it in a new place.

All the same features are still there. Nothing has been removed.

## For Developers: Hooks → Events

If you built custom functionality using V1's hooks system (`mwm.add_action()` etc.), those hooks have been replaced by the new event-based SDK. The capabilities are the same — and in most cases more flexible — but the syntax is different.

See the [Migrating from V1](/mapster-wp-maps-v2/developer/migrating-from-v1.md) guide in the Developer section for a full mapping of old hooks to new events.

## Using the Classic Editor

If you prefer the old editing interface, it's still available. Open any map in the Mapmaker and click **Use Classic Editor** in the top bar to switch back to the previous post-based editor. You can move between the two freely.

## Need to Roll Back to V1?

If you run into a bug or just want to wait while V2 continues to stabilize, you can roll back to the last V1 release. Download the zip below, then go to **Plugins > Add New > Upload Plugin** and install it over the existing plugin. Your data will not be affected.

[**Download WP Maps V1 (last release)**](https://drive.google.com/file/d/12M_6lV9H4ZIgMjfPaIigjJmPkqn80sEh/view?usp=drive_link) — Pro version

[**Download WP Maps V1 (last release)**](https://drive.google.com/file/d/1ztNdZpsFDwax1GJ6Q9xdYz-Bo8KfrEn8/view?usp=sharing) — Free version

> **Note:** Rolling back is safe — no map data or settings will be lost. When you're ready to try V2 again, just update the plugin normally.