Warning: Undefined array key 0 in /home/staging-yoast/staging-platform.yoast.com/versions/b6ab6cc77e40bc2acc362da080d5dcf3b4ac2281/web/app/themes/yoast-com/single-post.php on line 46

Move WordPress to a new domain in 10 easy steps!

Sometimes, branding, technical or business decisions mean that you need to change your domain. If you’re not careful, a poorly managed move can really hurt your SEO. Thankfully, WordPress makes things pretty easy – here’s everything you need to do.

10 steps to move WordPress

This guide assumes that you’re moving from one domain to another. If your migration is more complex (e.g., a subdomain on one site, to a folder on another), you may need to adapt the instructions.

  1. Take a backup of everything

    There’s a lot that can go wrong if you’re not careful when you start moving files and databases around. If you run into problems, it’s best to make sure that you can hit a ‘reset’ button and restore a backup.

  2. Add a robots.txt file to the new site

    Upload a robots.txt on the new domain (or edit it through your Yoast SEO plugin settings), with the following contents:

    User-agent: *
    Disallow: /

  3. Copy everything across

    Get a copy of your files and a copy of your database, then move everything across to your new hosting environment. You may need to configure your storage and database settings!

  4. Configure your wp-config.php file

    Make sure that you have the right database settings for the new hosting environment, and add the following lines (replacing example.com with the new domain).

    define('WP_SITEURL', 'https://www.example.com');
    define('WP_HOME', 'https://www.example.com');

  5. Access and configure your site

    Now everything should be accessible on the new website; but you should definitely double-check, and make sure that all of your settings are correct.

    If you have a caching plugin or system, don’t forget to empty out all of the old data.

  6. Find and replace old domain values

    Install the Search and Replace plugin, and do a search and replace for your old domain name with your new domain name.

  7. Remove the robots.txt file on the new site

    Now that your website is set up and ready to go, you can remove the robots.txt file which is preventing Google from seeing it.

  8. Set up a redirect on your old site

    Use your tool of choice to set up a redirect on your old site, so that all requests to your old domain trigger a 301 redirect to (the same page on) the new domain. Test this thoroughly!

  9. Remove your old code and database

    Apart from whatever code or tools you’re using to power the redirect from the old site to the new one, you can remove all your old code, content and databases.

  10. Update external services

    Don’t forget to change the settings on all of your third-party accounts which reference or integrate with your website. They’ll need the new domain name!

That should be it, you’ve moved WordPress to a new domain. If you have any suggestions or spot things that I’ve missed, please note them in the comments!

Read more: 6 questions about redirects for SEO »

Coming up next!


9 Responses to Move WordPress to a new domain in 10 easy steps!