How to use WP Engine Automated Migration tool?

This post is to help newly joined WP Engine user and a quick guide on how to use WP Engine automated migration tool and making your WordPress install easier.This post would cover entire migration process with commonly occurred error.

Download WP Engine Migration Plugin
You will need to download and install the plugin on your WordPress install that exists on your current hosting provider. You can find the plugin on the WordPress Plugin Repository. You can search for the plugin in your WordPress dashboard by searching for “WP Engine Migration”.

How to use WP Engine Migration tool?

Once the plugin is installed, activate the plugin so that it can be used.
Find the Information You Need
You will need 5 pieces of information to complete the migration:

Your Email
Destination URL
WP Engine SFTP Host
WP Engine SFTP Username
WP Engine SFTP Password
The Email you supply the plugin will be the email we use to communicate updates about your migration.

The Destination URL you use will be the desired URL.It’s highly recommend migrating to your temporary WP Engine URL ( first.


WP Engine SFTP Details are the connection details the plugin needs to move all your content to our platform. WP Engine have made this extremely easy to retrieve. You will have received an email titled WP Engine New Site Confirmation. This will contain a link that says “Migrate Your Site Now”. Click that link and it will show you the SFTP Details you need to supply to the plugin.

Note: If you did not receive an email with the Migrate Your Site Now link, you can still find the SFTP details you need by visiting where install-name is the name of the install you want to migrate your site to on WP Engine.

Start Your Migration

You should now have the plugin installed and activated on your current WordPress host and all the information you need to start the migration.

Go to the WP Engine Automated Migration tab in your WordPress Dashboard. Here you will find several text boxes that we will use during your migration. We strongly recommend that the Destination URL is your temporary WP Engine URL, which you will find in our New Site Confirmation Email we send you. This will allow you to visit your temporary WP Engine URL to see if the migration completed successfully.

Input the information into the plugin and press migrate! The plugin will then forward you to a page that will give you real time updates of your migration. If you see any issues, please refer to our Common Errors section further down this article. You will receive an email once the migration completes.

Finish Your Migration
You should have received an email saying your migration has completed. If you used the temporary WP Engine URL, you can visit that URL now in your browser to verify the site moved over properly.

If the site successfully moved over, you will need to re-run the migration one more time with the SAME email and SFTP credentials. Change the Destination URL this time to your live domain. For example, if your WordPress site is at, you would then put in the Destination URL. Click migrate again and the tool will re-start the migration.

Note: The tool is smart enough to know that this is a second migration. The migration tool will not migrate everything again. However, it will pick up any file and database changes or additions and migrate them over. This results in a faster migration.
What’s Left to Do?
Now that the heavy lifting is done, you have a few small tasks to complete to officially be on WP Engine. All of these may not apply to your migration:

Add your domain to the WP Engine User Portal
Setup your redirects
Setup SSL
Update your DNS
Once the applicable step above are completed, you will be fully on WP Engine. Welcome to the family!

Common Errors
Here are a list of errors that the plugin will tell you if something goes wrong along with the solution:

Could not connect to server. Please check the address.
The SFTP credentials you provided are incorrect. You can verify that you are using the right SFTP credentials by visiting where yourinstallname is replaced by the install name you would like to migrate your site to.
That email is already in use.
You are using an old version of the plugin. Please update or re-download the plugin from the plugin system.
Error! The URL specified is incorrect. Can you please check if your WP Engine account is configured with…
This means that the Destination URL you are using is not set up on the install you are trying to migrate the site too. Please read Add your domain to the WP Engine User Portal to fix this issue.
White Screen with an “Unknown” Error
Don’t be afraid, your site is still up and running. This error is caused by the Cloudflare plugin. Please deactivate that plugin and continue with the migration. Once completed, you can re-activate it on WP Engine’s platform.
The plugin is asking me for an additional username and password. What do I do?
Your WP Engine install is password protected. This is the case for both transferrable installs and installs that you made password protected via the User Portal. Just input the username and password for the password protected site. You can find the username and password in the User Portal. Please visit our support article to learn more about Transferrable Installs.
Don’t change any setting in the WP Engine User Portal during the migration.
The Automated Migration plugin does a lot of proactive checks to ensure the migration is going smoothly. When settings change during the migration, this can trigger one of those checks to fail resulting in a failed migration.
Known Host Incompatibilities
After extensive testing, we have found a few hosts that the plugin can not migrate you away from. These hosts are, but not limited too:
Local Hosting Environments
Proprietary Hosting Providers (,, and other similar companies)

Tagged with:

Leave a Reply