Upgrading from V1

What to expect when upgrading from WP Maps V1 to V2.

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.

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.

Download WP Maps V1 (last release) — Free version

Download WP Maps V1 (last release) — Pro version

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 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 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.