Automattic

Ron Rennick

Donncha O Caoimh (a11n)

<p>This plugin allows users of a WordPress MU site or WordPress 3.0 network to map their blog/site to another domain.</p>
<p>It requires manual installation as one file must be copied to wp-content/. When upgrading the plugin, remember to update domain_mapping.php and sunrise.php. Full instructions are on the Installation page and are quite easy to follow. You should also read <a href="http://ottopress.com/2010/wordpress-3-0-multisite-domain-mapping-tutorial/" rel="nofollow ugc">this page</a> too.</p>
<p>Super administrators must configure the plugin in Super Admin->Domain Mapping. You must enter the IP or IP addresses (comma deliminated) of your server on this page. The addresses are purely for documentation purposes so the user knows what they are (so users can set up their DNS correctly). They do nothing special in the plugin, they’re only printed for the user to see.</p>
<p>You may also define a CNAME on this page. It will most likely be the domain name of your network. See below for some restrictions and warnings.</p>
<p>Your users should go to Tools->Domain Mapping where they can add or delete domains. One domain must be set as the primary domain for the blog. When mapping a domain, (like ‘example.com’) your users must create an A record in their DNS pointing at that IP address. They should use multiple A records if your server uses more than one IP address.<br />
If your user is mapping a hostname of a domain (sometimes called a “subdomain”) like www.example.com or blog.example.com it’s sufficient to create a CNAME record pointing at their blog url (NOT IP address).</p>
<p>The login page will almost always redirect back to the blog’s original domain for login to ensure the user is logged in on the original network as well as the domain mapped one. For security reasons remote login is disabled if you allow users to use their Dashboard on the mapped domain.</p>
<p>Super admins can now choose to either allow users to setup DNS ANAME records by supplying an IP (or list of IP addresses) or set a CNAME but not both (entering a CNAME for the end user voids the use of IP’s)</p>
<p>There is a lot of debate on the handling of DNS using CNAME and ANAME so both methods are available depending on your preference and setup.</p>
<p>Things to remember:</p>
<ul>
<li>CNAME records that point to other CNAME records should be avoided (RFC 1034 section 5.2.2) so only tell your end users to use your chosen domain name as their CNAME DNS entry if your domain name is an ANAME to an IP address (or addresses)</li>
<li>Only use the CNAME method if your main domain is an ANAME of an IP address. This is very important. How do you know? Check your dns or ask your hosting company.</li>
<li>Giving your users the option to just use your chosen domain name and not an IP (or list of IP’s) to set as their CNAME will make administration of your WordPressMU blog platform or WordPress 3.0 network easier, an example of this would be purchasing/deploying a new server or indeed adding more servers to use in a round robin scenario. Your end users have no need to worry about IP address changes.</li>
<li>Finally, telling your end users to use an ANAME IP or CNAME domain name is up to you and how your systems are deployed.</li>
<li>Further Reading: http://www.faqs.org/rfcs/rfc2219.html</li>
<li>For localization: place translation files (ie. wordpress-mu-domain-mapping-xx_XX.mo) in the directory wp-content/plugins/wordpress-mu-domain-mapping/languages. You will probably have to create that directory yourself.</li>
</ul>
<h3>Action Hooks</h3>
<p>You can now hook into certain parts of the domain_mapping mu-plugin to enable you to extend the features that are built in without the need to modify this plugin. To do this, just create a script within the mu-plugins dir that is called AFTER this plugin (eg, call it domain_mapping_extended.php).</p>
<ul>
<li><code>dm_echo_updated_msg</code></li>
</ul>
<p>This hook is for when you want to add extra messages for your end users when they update their settings, the current usage would be to remove the existing action and replace it with your own as shown within the example further down the page.</p>
<ul>
<li><code>dm_handle_actions_init</code></li>
</ul>
<p>Before we add our own handlers for our users wanting to update their mappings, we can use this action to maybe connect to your datacenter API ready for communication.  An example would be to load an API class and connect before we send and recieve XML queries. Once again, see the example down the page. Your function can make use of the $domain variable.</p>
<ul>
<li><code>dm_handle_actions_add</code></li>
</ul>
<p>When an user adds a domain name to their mappings, this action can be used to perform other tasks on your server.  An example would be to check the user has already set up the DNS records for the name to correctly point to your server.  Your function can make use of the $domain variable.</p>
<ul>
<li><code>dm_handle_actions_primary</code></li>
</ul>
<p>This may or may not be commonly used in most cases but is there just in case. Your function can make use of the $domain variable.</p>
<ul>
<li><code>dm_handle_actions_del</code></li>
</ul>
<p>When an user deletes one of their domain mappings, this action can be used to reverse what dm_handle_actions_add has done.  An example would be to remove the domain mapping from your server using your datacenter’s API.  Your function can make use of the $domain variable.</p>
<ul>
<li><code>dm_delete_blog_domain_mappings</code></li>
</ul>
<p>If the blog is ever deleted and you make use of handle_actions, then this action will enable you to tidy up.  An example would be when an user has set up multiple domain mappings and the blog is deleted, your function can remove any mess left behind.  Your function can make use of the $domains array (numbered array of domains).  NOTE, this will also be called if the user has no mappings, care should be taken in the case of an empty array.</p>
<h4>EXAMPLE USAGE</h4>
<pre><code><?php // Filename: mu-plugins/domain_mapping_extended.php


// NOTE,
//  This example will not 'just work' for anyone, it is to show basic
//  usage of dm_echo_updated_msg, dm_handle_actions_init and
//  dm_handle_actions_add


// We do not need translations but would really like a message when a
// users DNS entry is not ready

function dm_echo_extended_updated_msg() {
    switch( $_GET[ 'updated' ] ) {
        case "add":
            $msg = 'You have added a new domain name.';
            break;
        case "exists":
            $msg = 'That domain name already exists, please try again.';
            break;
        case "primary":
            $msg = 'New primary domain created - enjoy!';
            break;
        case "del":
            $msg = 'The domain name has been removed.';
            break;
        case "dnslookup":
            $msg = 'The domain is not pointing to ' .
            get_site_option( 'dm_cname' ) . ', please set up your DNS.';
        break;
    }
    echo "<div class='updated fade'><p>$msg</p></div>";
}
// REMOVE THE ORIGINAL MESSAGES
remove_action('dm_echo_updated_msg','dm_echo_default_updated_msg');
// REPLACE WITH OUR OWN
add_action('dm_echo_updated_msg','dm_echo_extended_updated_msg');


// Prepare to use our Datacenter API

function dm_extended_handle_actions_init($domain) {
    global $datacenter_api;
    // There is a good chance we will be accessing the datacentre API
    require_once(dirname(__FILE__) ."/classes/xmlAbstract.class.php");
    require_once(dirname(__FILE__) ."/classes/xmlParserClass.php");
    require_once(dirname(__FILE__) ."/classes/datacenterAPIClass.php");
    $datacenter_api = new datacenter_api('MY_API_KEY', 'API_TYPE');
}
$datacenter_api = null;
add_action('dm_handle_actions_init', 'dm_extended_handle_actions_init');


// Check the users DNS is ready to go (we are using the CNAME option)
// then add the mapping to the datacenter API

function dm_extended_handle_actions_add($domain) {
    global $datacenter_api;
    // Check the domain has the correct CNAME/ANAME record
    $dmip = gethostbyname(get_site_option( 'dm_cname' ));
    $urip = gethostbyname($domain);
    if ($dmip != $urip) {
        wp_redirect( '?page=domainmapping&updated=dnslookup' );
        exit;
    }
    $datacenter_api->add_mapping($domain);
}
add_action('dm_handle_actions_add', 'dm_extended_handle_actions_add');
?>
</code></pre>


WordPress MU Domain Mapping

Successfully installed and configured in my site. Thank you! :-)

Works well

This plugin saved me so much work. Works great.

Perfect

The official WordPress Codex states: "In WordPress 4.5+, domain mapping is a native feature." 

Unfortunately, this plugin is no longer maintained, even though it is still the best, safest and easiest way to ensure perfect redirection to to correct (sub) blog. 

The mentioned define('COOKIE_DOMAIN', $_SERVER['HTTP_HOST']); often results in wrong redirections to the main blog:
In WordPress Network Admin: http://www.mydomain.org/ will likely make typing mydomain.org redirect to the main blog: https://example.com/?signup=new

At the time of writing this review I am still very happily using WordPress MU Domain Mapping on WordPress MultiSite 5.7.1-alpha-50553, PHP 8.0.2. to ensure that my visitors end up on the correct blog (http, https, with and without www).

In wp-config.php: 
define('MULTISITE', true);
define('SUBDOMAIN_INSTALL', true);
define('PATH_CURRENT_SITE', '/');
define('SITE_ID_CURRENT_SITE', 1);
define('BLOG_ID_CURRENT_SITE', 1);

/* Prevent redirection to /?signup=new */
define('NOBLOGREDIRECT', 'https://www.main-domain.com');
define('SUNRISE', 'on');



The defined COOKIE_DOMAIN will be set by this plugin to the correct url of all your blogs.

Still the best solution!

Excellent, minimalistic plugin that still works 8 years after its last update.

Still works with WP 5.3 👍

Map any blog/site on a WordPressMU or WordPress 3.X network to an external domain.

Arindo Duque

David Stone

Marcus Quinn

Valentin Vuckovic

<p><strong>Ultimate Multisite</strong> is a WordPress Multisite plugin designed to help you build, sell, and manage a Website-as-a-Service (WaaS) platform on your own infrastructure.</p>
<p>With Ultimate Multisite, you can create subscription plans, provision new sites from templates, map custom domains, and manage customers across your WordPress Multisite network — all from one integrated system built specifically for Multisite.</p>
<p>Launch niche site builders, productized services, franchise networks, or internal platforms without stitching together dozens of plugins. From checkout to provisioning to ongoing management, Ultimate Multisite provides the core building blocks for running a modern, scalable WordPress multisite platform.</p>
<p>Formerly known as <strong>WP Ultimo</strong>, Ultimate Multisite is now community-maintained and actively improved.</p>
<h4>Also Known As</h4>
<p>Ultimate Multisite is commonly searched for as:</p>
<ul>
<li>Ultimate Multisite plugin</li>
<li>Ultimate Multisite WordPress</li>
<li>Multisite Ultimate</li>
<li>WP Ultimo</li>
</ul>
<p>If you are looking for <strong>WP Ultimo</strong>, this is the community-maintained successor.</p>
<h4>Key Features</h4>
<p>Everything you need to build and scale a WordPress Multisite SaaS platform:</p>
<ul>
<li><strong>Fast Site Creation</strong> – Self-serve signup that provisions new sites instantly from templates</li>
<li><strong>Domain Mapping</strong> – Custom domains with automated DNS verification and guided setup</li>
<li><strong>Payments & Subscriptions</strong> – Stripe and PayPal support for recurring plans and one-time fees</li>
<li><strong>Flexible Plans & Limits</strong> – Package features and enforce quotas across your multisite network</li>
<li><strong>Template Library</strong> – High-converting site templates customers can launch in minutes</li>
<li><strong>Customer Dashboard</strong> – Branded UI for managing billing, sites, domains, and settings</li>
<li><strong>White-Label Ready</strong> – Rename, rebrand, and customize the experience</li>
<li><strong>Hosting Integrations</strong> – Cloudflare, GridPane, Cloudways, WPMU DEV, and more</li>
<li><strong>Developer-Friendly</strong> – Hooks, filters, and an extensible add-on system</li>
</ul>
<h4>Who Is Ultimate Multisite For?</h4>
<ul>
<li>Agencies productizing WordPress into recurring plans</li>
<li>Creators launching niche or industry-specific site builders</li>
<li>Hosts and MSPs offering white-label WordPress platforms</li>
<li>Franchises and multi-location brands managing many similar sites</li>
<li>Universities and organizations provisioning sites at scale</li>
<li>Internal teams deploying microsites and campaigns</li>
</ul>
<h4>Popular Use Cases</h4>
<ul>
<li>Productized website services with recurring billing</li>
<li>Franchise and multi-location networks with brand-consistent sites</li>
<li>Industry-specific “site builder” platforms</li>
<li>Private networks for events, departments, or communities</li>
<li>Educational institutions provisioning program or class sites</li>
</ul>
<h4>Why Choose Ultimate Multisite</h4>
<ul>
<li><strong>Built for WordPress Multisite</strong> – Not retrofitted from single-site assumptions</li>
<li><strong>Open & Community-Maintained</strong> – Transparent development and frequent updates</li>
<li><strong>Proven Architecture</strong> – Templates, plans, and domain mapping built-in</li>
<li><strong>Extensible by Design</strong> – Add-ons, actions, filters, and hosting integrations</li>
<li><strong>You Own the Stack</strong> – No forced SaaS lock-in or proprietary hosting</li>
</ul>
<p>If you searched for “Ultimate Multisite” on the WordPress plugin directory, this plugin provides the full multisite SaaS and WaaS functionality you are looking for.</p>
<h4>Get Started in Minutes</h4>
<ol>
<li>Enable WordPress Multisite on a staging or production site</li>
<li>Install and <strong>Network Activate Ultimate Multisite</strong></li>
<li>Run the setup wizard and create your first plan and template</li>
<li>Share your signup page and start provisioning sites</li>
</ol>
<h3>Documentation</h3>
<ol>
<li><a href="https://ultimatemultisite.com/2026/01/27/getting-started-ultimate-multisite-guide/" rel="nofollow ugc">Ultimate Multisite Getting Started Guide</a></li>
<li><a href="https://ultimatemultisite.com/docs/" rel="nofollow ugc">Full Ultimate Multisite Documentation</a></li>
</ol>
<h3>Requirements</h3>
<ul>
<li>WordPress Multisite 5.3 or higher</li>
<li>PHP 7.4.30 or higher</li>
<li>MySQL 5.6 or higher</li>
</ul>
<h3>Support</h3>
<p>For support, please open an issue on the <a href="https://github.com/superdav42/wp-multisite-waas/issues" rel="nofollow ugc">GitHub repository</a>.</p>
<h3>External Services</h3>
<p>This plugin connects to external services to provide optional functionality. All services are disclosed during setup and can be enabled or disabled as needed.</p>
<h4>Geolocation Services</h4>
<p><strong>MaxMind GeoLite2</strong><br />
– Downloads a geolocation database (no personal data sent)<br />
– Used only when geolocation features are enabled<br />
– https://www.maxmind.com/en/privacy-policy</p>
<p><strong>IP Lookup APIs</strong><br />
– Used to determine public IP address (no data stored)<br />
– Services include IPify, IPinfo.io, IP-API, and others</p>
<h4>Plugin Updates and Add-ons</h4>
<p><strong>Ultimate Multisite Update Server</strong><br />
– Sends site URL, plugin version, and license metadata<br />
– Used for plugin and add-on updates<br />
– https://ultimatemultisite.com/privacy-policy/</p>
<h4>Payment Processing</h4>
<p><strong>Stripe</strong><br />
– Processes card payments and subscriptions<br />
– When using the Stripe integration, a 3% fee per-transaction is applied to support ongoing development. This fee is waived for sites that have purchased any addon from ultimatemultisite.com. The fee is collected by Stripe as part of the payment and does not affect the amount charged to your customers.<br />
– https://stripe.com/privacy</p>
<p><strong>PayPal</strong><br />
– Processes PayPal payments<br />
– https://www.paypal.com/us/legalhub/privacy-full</p>
<h4>Hosting Integrations</h4>
<p>Integrations may send site configuration data and API credentials only when explicitly enabled.</p>
<p>Supported providers include:<br />
– Cloudflare<br />
– Closte<br />
– Cloudways<br />
– GridPane<br />
– WPMU DEV</p>
<h4>Usage Tracking (Opt-In)</h4>
<p>Anonymous telemetry is <strong>disabled by default</strong> and requires explicit opt-in.</p>
<p>Data collected includes:<br />
– WordPress and PHP versions<br />
– Plugin version and enabled add-ons<br />
– Anonymized usage ranges</p>
<p>No personal data, domains, IP addresses, or payment information are collected.</p>


Ultimate Multisite – WordPress Multisite SaaS & WaaS Platform


I've an Ultimate Multisite plugin user for a long time (Formerly known as and forked from WP Ultimo).



It solves everything I need to use Wordpress Multisite, instead of single WordPress instances, which saves a lot of time on only having one stack to update plugins on.



It is more cost-efficient for cheaper Wordpress hosting, as you're not paying for all the duplication of plugin storage and processing.



Well done for making this fantastic plugin open-source and community developed on GitHub.



Highly recommended!


Best WordPress Multisite Plugin for Self-Hosting as a SaaS


Probably one of the best multisite plugins I’ve ever seen in my life.


The Beginning of Something Big

Ultimate Multisite turns your WordPress network into a WaaS platform with subscriptions, site provisioning, and domain mapping.

WordPress MU Domain Mapping vs Ultimate Multisite – WordPress Multisite SaaS & WaaS Platform