Skip to content

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.

Phillip RosenheinrichLast reviewed 2 min readApplies to Multisite Migrate 1.2.24

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

  1. Back up the network
    Run a full network backup in Network Admin → Multisite Migrate → Backups.
  2. Start a restore as migration
    Open the restore wizard on that backup and choose Migration instead of Same server.
  3. 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.
  4. Check wp-config.php
    If DOMAIN_CURRENT_SITE still contains the old domain, change it. Remove a hard-coded COOKIE_DOMAIN that points to the old domain.
    define( 'DOMAIN_CURRENT_SITE', 'new-domain.com' );
    define( 'PATH_CURRENT_SITE', '/' );
  5. 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
  6. 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

  1. Restore guideMultisite Migrate · checked November 9, 2026
  2. wp search-replace (WP-CLI command)WordPress Developer Resources · checked November 9, 2026
  3. WordPress Multisite / NetworkWordPress Developer Resources · checked November 9, 2026

Make your first restorable network backup for free.

14-day money-back on Plus & Pro