Multisite migration
Change the Domain of a WordPress Multisite
Move a network from old-domain.com to new-domain.com: DNS and SSL first, then a restore with URL mapping, then wp-config.php and a leftover-URL check.
Before you start
- A fresh full network backup.
- The new domain points to the server; for subdomain networks also the wildcard
*.new-domain.com. - An SSL certificate that covers the new domain (and subdomains, if you use them).
- File access to wp-config.php.
Steps
- Back up the network
Run a full network backup in Network Admin → Multisite Migrate → Backups. - Start a restore as migration
Open the restore wizard on that backup and choose Migration instead of Same server. - Map old to new
Enter the old and new site URL and home URL, preview the changes and map every subsite domain that changes. The restore rewrites serialized data safely. - Check wp-config.php
IfDOMAIN_CURRENT_SITEstill contains the old domain, change it. Remove a hard-codedCOOKIE_DOMAINthat points to the old domain.define( 'DOMAIN_CURRENT_SITE', 'new-domain.com' ); define( 'PATH_CURRENT_SITE', '/' ); - Look for leftovers
Search for the old domain. With Pro, run the migration verification and confirm the replacements; otherwise WP-CLI can do a dry run first.wp search-replace 'https://old-domain.com' 'https://new-domain.com' --network --dry-run - Redirect the old domain
Keep the old domain pointing to the server and redirect it with 301 to the new URLs, so links and rankings carry over.
Troubleshooting
Frequently asked questions
Can I change only one subsite's domain?
Yes. Edit that site in Network Admin → Sites (site address) and replace its URLs in that site's tables only. The rest of the network stays untouched.
Is a domain change included in Free?
Yes. The restore wizard's Migration option with URL mapping is available on all plans. The leftover-URL verification and WP-CLI commands of Multisite Migrate are Pro.
Does Google need anything after the change?
Keep 301 redirects from every old URL, add the new domain in Search Console and use its change-of-address tool.
Sources
Related guides and comparisons
Make your first restorable network backup for free.