WordPress multisite domain mapping for the modern era.

Installs: 141 298

Dependents: 6

Suggesters: 0

Security: 0

Stars: 512

Watchers: 74

Forks: 67

Open Issues: 42


1.0.3 2018-10-30 18:53 UTC


WordPress multisite domain mapping for the modern era.
Build status Coverage via
A Human Made project. Maintained by @rmccue. 68747470733a2f2f686d6e2e6d642f636f6e74656e742f7468656d65732f686d6e6d642f6173736574732f696d616765732f686d2d6c6f676f2e737667

Mercator is a domain mapping plugin for the New World. Using new features included with WordPress 3.9 and later, Mercator builds on the new multisite features and abilities to improve your world.

Stop using outdated practices, and start making sense.


Mercator requires WordPress 3.9 or newer for the new sunrise processes. Mercator also requires PHP 5.3+ due to the use of namespaced code.

What is Domain Mapping?

When setting up a Multisite install, the network is configured to create sites either as subdomains of the root site (e.g. or subfolders (e.g.

Domain Mapping is the process of mapping any arbitrary domain (called an alias) to load a site. If an alias of is set for the site, the site and wp-admin interface can be accessed over either the alias or the original URL.

Internally, Mercator looks at a request's domain and informs WordPress what set of tables to use. User authentication cookies are set for all domains in the network, so a user logs in on one site and is authenticated across all.


Mercator must be loaded during sunrise.

We recommend dropping Mercator's directory into your mu-plugins directory. You may need to rename the folder from Mercator-master to mercator.

Then create a wp-content/sunrise.php file with the following:

// Default mu-plugins directory if you haven't set it
defined( 'WPMU_PLUGIN_DIR' ) or define( 'WPMU_PLUGIN_DIR', WP_CONTENT_DIR . '/mu-plugins' );

require WPMU_PLUGIN_DIR . '/mercator/mercator.php';

Additionally, in order for sunrise.php to be loaded, you must add the following to your wp-config.php:

define('SUNRISE', true);

Aliases are created in the Network Admin > Sites > Edit Site screen.

DNS for mapped domains must be configured for the domain to point to the WordPress installation, as well as configuring the web server to route requests for the domain to the WordPress application.

Upgrading from WPMU Domain Mapping

This plugin is a complete replacement for WPMU Domain Mapping. The database structure is fully compatible.

Note that if you have Domain Mapping code in your sunrise, you should remove this and replace it with the recommended sunrise code above. Mercator hooks in to WordPress' internal site mapping code rather than replacing it, unlike Domain Mapping.


Mercator is licensed under the GPLv2 or later.


Created by Human Made for high volume and large-scale sites, such as Happytables. We run Mercator on sites with millions of monthly page views, and thousands of sites.

Written and maintained by Ryan McCue. Thanks to all our contributors.

Mercator builds on concepts from WPMU Domain Mapping, written by Donncha O'Caoimh, Ron Rennick, and contributors.

Mercator relies on WordPress core, building on core functionality added in WP27003. Thanks to all involved in the overhaul, including Andrew Nacin and Jeremy Felt.

Interested in joining in on the fun? Join us, and become human!