WP Engine Site Migration Plugin: A Step-by-Step Guide for a Flawless Move

By
28 Min Read

WP Engine Site Migration Plugin: A Step-by-Step Guide for a Flawless Move

Moving a WordPress website can feel like a high-stakes operation. The fear of downtime, data loss, or broken functionality is enough to cause sleepless nights for any site owner. Thankfully, if you're moving to WP Engine's managed hosting, the process is made significantly simpler with the official wp engine site migration plugin. This free tool is designed to automate the heavy lifting, turning a complex technical task into a straightforward, guided process.

This guide will walk you through every aspect of using the WP Engine migration tool. We'll cover the entire process from preparation to post-migration checks, ensuring you have the confidence to move your site without any hitches. Whether you're a seasoned developer or a business owner managing your own site, you'll find clear, actionable steps to make your transition to WP Engine a success.

What You'll Learn

  • Step-by-Step Instructions: A detailed walkthrough of how to use the WP Engine migration plugin from start to finish, including where to find the necessary credentials.
  • Key Benefits: Understand why using the official plugin is the recommended method for transferring your site, focusing on its reliability, speed, and cost-effectiveness.
  • Troubleshooting Common Issues: Learn how to identify and resolve frequent problems that can occur during a migration, such as timeouts or database errors.
  • Post-Migration Essentials: A comprehensive checklist of tasks to complete after the migration is finished to ensure your site is fully functional and optimised on its new server.

An Overview of the WP Engine Site Migration Plugin

The WP Engine Site Migration plugin is a purpose-built tool designed to simplify moving a WordPress site to the WP Engine or Flywheel hosting platforms. Developed in a collaboration between WP Engine and Automattic (the company behind WordPress.com), it provides a reliable and streamlined method for transferring your site's files and database.

Unlike manual migrations that require you to use FTP clients, manage SQL database exports, and perform complex search-and-replace operations, this plugin handles it all from within your WordPress dashboard. It securely copies your entire site—including your theme, plugins, media files, and database—to your new WP Engine environment. The plugin also intelligently handles URL updates, which is one of the most common points of failure in manual moves.

wp engine site migration plugin

This tool is not a general-purpose backup or cloning plugin. It is specifically engineered to work with the server architecture at WP Engine. This specialisation is its greatest strength, as it's optimised to handle the specific configurations and security protocols of the platform, resulting in a higher success rate and fewer compatibility issues than generic migration tools.

Before You Begin: Technical Requirements & Prerequisites

Before you start the migration process, it's important to ensure both your current site (the source) and your new WP Engine environment (the destination) meet the necessary requirements. Getting these details in order first will prevent most common migration failures. A few minutes of preparation can save you hours of troubleshooting later.

Here’s what you need to have ready:

  • An Active WP Engine Plan: You must have an active hosting plan with WP Engine and have already created an environment (e.g., yourinstall.wpengine.com) for the site you intend to migrate.
  • WordPress Admin Access: You need administrator-level access to the WordPress dashboard of the site you are moving.
  • Updated WordPress Core, Themes, and Plugins: For the best results, ensure your source site is running the latest version of WordPress and that all your themes and plugins are up to date. This reduces the risk of compatibility issues.
  • Server Requirements: Your current host must meet some basic technical standards. The plugin generally requires PHP version 7.4 or newer and a WordPress version of 5.5 or higher. While it may work on older versions, using current software is strongly recommended for security and performance.

Most importantly, you will need to gather your SFTP credentials from your WP Engine User Portal. These are the details the plugin uses to connect to your new hosting environment. You will need:

  1. Destination Site URL: This is the temporary URL for your new environment (e.g., yourinstall.wpengine.com).
  2. SFTP Host/Address: The server address for connecting via SFTP.
  3. SFTP Username: Your unique SFTP username for that specific environment.
  4. SFTP Password: The password associated with your SFTP user.

You can find all of these details in your WP Engine User Portal by selecting the specific environment and navigating to the 'SFTP users' section. Keep these details handy, as you'll need to enter them into the plugin.

A Step-by-Step Guide to Using the WP Engine Migration Plugin

wp engine site migration plugin

With your preparations complete, you're ready to begin the migration. The process is designed to be user-friendly and is managed entirely from the WordPress dashboard of your original site. Follow these steps carefully for a smooth transfer.

Step 1: Install the Plugin on Your Source Site

First, you need to install the WP Engine Automated Migration plugin on the website you want to move. This is the site currently hosted with your old provider.

  1. Log in to your WordPress admin dashboard.
  2. Navigate to Plugins > Add New.
  3. In the search bar, type “WP Engine Automated Migration”.
  4. Locate the plugin in the search results and click Install Now.
  5. Once the installation is complete, click Activate.

After activation, you will see a new item in your admin menu labelled “Site Migration”.

Step 2: Enter Your Migration Details

This is where you'll use the SFTP credentials you gathered earlier. This step authorises the plugin to connect to your new WP Engine server and begin the transfer.

  1. Click on the Site Migration menu item in your WordPress dashboard.
  2. You will be presented with a form asking for your email address and the destination site details.
  3. Enter your email address. The plugin will send notifications here about the migration status.
  4. Carefully enter the Destination Site URL, SFTP Host, SFTP Username, and SFTP Password from your WP Engine User Portal.
  5. The plugin offers an option to add a password to your migrated site (HTTP Basic Authentication). This is a good security measure to prevent public access while you are reviewing the migrated site. You can choose to set one or leave it blank.

Double-check that all the details are correct before proceeding. A simple typo in the SFTP credentials is the most common reason for a connection failure.

Step 3: Start the Migration

Once you've entered and verified your details, click the Migrate button. The plugin will first perform a series of checks to ensure it can connect to the destination server and that the environment is ready. If the checks pass, the migration process will begin automatically.

The plugin will display a progress screen showing you what stage it's at—backing up the database, transferring files, and so on. The duration of the migration depends on the size of your website. A small blog might take 15-20 minutes, while a large e-commerce site with thousands of images could take several hours.

Pro Tip: Schedule your migration during a period of low traffic for your website. Although the plugin works on a copy and your live site remains online, starting the process when fewer users are active minimises the risk of any data (like new comments or orders) being missed during the transfer window.

Step 4: Verify the Migrated Site

Once the migration is complete, the plugin will notify you. Your site has now been copied to your WP Engine temporary URL (e.g., yourinstall.wpengine.com). It's crucial to thoroughly check the migrated site before pointing your domain's DNS to the new server.

Use the temporary URL to browse the copied site. Check the following:

  • Homepage and main pages: Do they load correctly?
  • Images and media: Are all images displaying properly?
  • Links: Click through your navigation menu and internal links to ensure they work.
  • Functionality: Test contact forms, user logins, and any e-commerce checkout processes.
  • Admin Area: Log in to the WordPress admin on the temporary URL and ensure everything looks correct.

If everything checks out, you are ready for the final step: going live.

Why Use the Official WP Engine Transfer Plugin? Key Benefits

While there are many ways to move a WordPress site, using the official site migration plugin for WP Engine offers several distinct advantages. It's the method recommended by WP Engine for a reason, as it's tailored specifically for their platform, ensuring a higher degree of reliability and efficiency.

First and foremost is its reliability. The plugin is built to understand WP Engine's server architecture. It knows where to place files, how to configure the database connection, and how to handle the platform's unique caching layers. This eliminates the guesswork and potential configuration errors that can arise when using generic migration tools or manual methods.

Second is the simplicity and speed. The entire process is managed through a simple interface within your WordPress dashboard. There's no need to download large backup files to your local computer and then re-upload them, which can be incredibly slow and prone to interruption. The plugin facilitates a direct server-to-server transfer, which is significantly faster and more stable.

Finally, it's cost-effective. The WP Engine Site Migration plugin is completely free to use for all WP Engine customers. Other premium migration plugins or services can cost anywhere from £50 to over £250 for a single site migration. By providing this powerful tool for free, WP Engine removes a significant financial barrier for customers moving to their platform.

Common Migration Problems and How to Fix Them

wp engine site migration plugin

Even with a great tool, migrations can sometimes hit a snag. Most issues are related to the configuration of the source server, as it might have limitations that interfere with the plugin's process. Here are some of the most common problems and how to resolve them.

Migration Fails to Start or Times Out

This is often caused by security plugins or server-level restrictions on your old host. Security plugins like Wordfence or iThemes Security might block the plugin's requests, seeing them as suspicious activity. The solution is to temporarily disable security plugins on your source site just before you start the migration. Remember to re-enable them if you decide to abort the migration.

Server timeouts can also occur on very large websites or on underpowered shared hosting. The plugin might not have enough server resources (memory or execution time) to package your files. If this happens, you may need to contact your old host and ask them to temporarily increase the max_execution_time and memory_limit for your site. Alternatively, you can perform the migration via WP-CLI on your server if you have SSH access, as this method is less prone to HTTP timeouts.

Database Connection Errors

If the plugin reports it cannot connect to the database, it's usually an issue with the credentials provided or a firewall blocking the connection. Double-check that you have copied the SFTP username and password correctly from the WP Engine portal. Also, ensure there are no leading or trailing spaces. If the credentials are correct, a firewall on your old host might be blocking outbound connections.

You may need to ask their support team to whitelist connections to the WP Engine server IP.

File Permission Issues

Occasionally, the migration might complete, but some images or theme assets appear broken. This can be due to incorrect file permissions on your original server that were copied over. The plugin tries to correct these, but sometimes manual intervention is needed. After migrating, you can use the 'Reset File Permissions' tool within the WP Engine User Portal for your new environment.

This tool will automatically apply the correct, secure permissions to all your files and folders.

WP Engine Migration Tool vs. Other Methods: A Quick Comparison

To fully appreciate the value of the WP Engine migration tool, it helps to compare it with other common methods for moving a WordPress site. Each approach has its place, but for this specific task, the official plugin is hard to beat.

Here’s a breakdown of the different options:

MethodBest ForEase of UseCostKey Consideration
WP Engine PluginMigrating to WP EngineVery EasyFreeOptimised for WP Engine's platform; highest success rate.
Manual Migration (FTP/phpMyAdmin)Developers who need full controlDifficultFreeHigh risk of human error, time-consuming, requires technical expertise.
Third-Party Plugins (e.g., Duplicator)Migrating between any two hostsModerateFree/PaidCan be very effective but may require configuration for specific hosts.
Hosting Provider Migration ServiceUsers who want a hands-off solutionVery EasyPaid/FreeSome hosts offer this, but it can be expensive or have long wait times.

As the table shows, the WP Engine transfer plugin hits the sweet spot of being easy, free, and specifically designed for the job. Manual migrations grant the most control but are also the most difficult and riskiest. Third-party plugins are a good all-around solution but lack the specific optimisations for WP Engine's environment, which can sometimes lead to subtle issues with caching or permissions.

Best Practices for a Successful Site Migration

Following best practices can make the difference between a stressful migration and a seamless one. Here are some key tips to ensure your move goes smoothly.

  1. Create a Full Backup First: Before you do anything, create a complete backup of your source site. Use a trusted backup plugin or your current host's backup feature. This is your safety net. If anything goes wrong, you can restore your site to its original state without any data loss.

  2. Clean Up Your Site: A migration is a perfect opportunity for a spring clean. Delete unused plugins and themes, remove old post revisions, and optimise your database. A leaner site will migrate faster and perform better on the new server.

  3. Choose a Low-Traffic Time: As mentioned earlier, run the migration when your site has the fewest visitors. For most businesses, this is late at night or over the weekend. This minimises the chances of losing any new data, like contact form submissions or sales, generated during the transfer.

  4. Keep the Browser Tab Open: While the migration is running, keep the browser tab with the progress screen open. Closing it won't necessarily stop the process (which runs on the server), but it's the best way to monitor its status in real-time.

  5. Don't Make Changes to the Source Site: Once you start the migration, avoid making any changes to your original site. Don't publish new posts, approve comments, or update plugins. Any changes made after the process begins will not be included in the migrated copy.

Real-World Success: Migration Case Studies

To illustrate how the plugin works in practice, let's look at two common scenarios where the WP Engine migration tool proves invaluable.

Case Study 1: The Local Bakery Blog

A small bakery owner runs a WordPress blog to share recipes and showcase her products. Her site, hosted on cheap shared hosting, has become slow as her traffic has grown. She decides to move to WP Engine for better performance. With limited technical skills, a manual migration is out of the question.

She installs the WP Engine site migration plugin, enters her SFTP details from the User Portal, and clicks 'Migrate'.

Forty minutes later, she receives an email that the migration is complete. She reviews the site on its temporary URL, tests her contact form, and confirms all her recipe images are present. The entire process was completed in under an hour without writing a single line of code or using an FTP client. She then updates her DNS, and her faster, more reliable site is live on WP Engine.

Case Study 2: The Growing E-commerce Store

An online store built with WooCommerce is experiencing performance issues during peak shopping times. The owner decides to move to a WP Engine e-commerce plan for its scalability and dedicated infrastructure. The site has thousands of products, customer accounts, and order histories, making data integrity a top priority.

Using the WP Engine migration tool, the development team initiates the transfer during a planned maintenance window overnight. Due to the large amount of data, the migration takes about three hours. Once complete, they perform a rigorous testing process on the staging environment, placing test orders and verifying customer login functionality. Because the plugin handles database URL serialisation correctly, all customer and order data is transferred perfectly.

The move results in a 50% reduction in page load times, leading to a noticeable increase in conversions.

Your Post-Migration Checklist: What to Do After the Transfer

Successfully copying your site is a major milestone, but the job isn't finished yet. Completing a post-migration checklist is essential to ensure a seamless transition for your users and search engines.

Here are the critical steps to take after the plugin finishes:

  1. Thoroughly Test the Staging Site: We mentioned this before, but it's worth repeating. Go through the migrated site on its temporary URL with a fine-tooth comb. Test everything: forms, links, plugins, and any special features.

  2. Update Your DNS Records: This is the step that makes your site 'live' on WP Engine. Log in to your domain registrar (where you bought your domain name) and update the A record or CNAME record to point to the IP address or CNAME provided by WP Engine. DNS changes can take a few hours to propagate worldwide.

  3. Install an SSL Certificate: Once your DNS has updated, install an SSL certificate on your WP Engine environment. WP Engine offers free Let's Encrypt SSL certificates that can be installed with a single click from the User Portal.

  4. Search and Replace for Mixed Content: Even though the plugin is very good at updating URLs, sometimes 'mixed content' warnings can occur if some assets are still being loaded over http://. Use a plugin like Better Search Replace to do a final check for any instances of your old http:// domain and replace them with the new https:// version.

  5. Reset Permalinks: Log in to your new site's WordPress admin, go to Settings > Permalinks, and simply click Save Changes without making any edits. This rebuilds the .htaccess file and can fix any 404 errors on internal pages.

  6. Deactivate and Delete the Migration Plugin: Once you are certain the migration is successful and your site is live, you no longer need the migration plugin on your new site. Deactivate and delete it.

Pro Tip: Use a tool like Google's Mobile-Friendly Test and PageSpeed Insights to test your new live site. This helps confirm that everything is loading correctly for both users and search engine crawlers, and it gives you a new performance benchmark.

What Users Are Saying: Reviews and Feedback

Overall, the WP Engine Site Migration plugin is highly regarded by the WordPress community for its intended purpose. Users consistently praise its simplicity and effectiveness, especially for standard WordPress installations. The ability to move a site without deep technical knowledge is its most celebrated feature.

Feedback often highlights how the plugin saves hours of work compared to manual methods. Many developers and agencies who regularly move client sites to WP Engine consider it an essential part of their workflow. However, like any tool, it's not without its critics. Some users with highly complex or non-standard WordPress setups have reported issues.

For example, sites with extensive custom code, unusual directory structures, or extremely large databases (over 10GB) can sometimes challenge the automated process.

In a discussion on Reddit, one user in the r/Wordpress community noted that while the plugin is excellent for most cases, they still perform a manual check of database URLs post-migration out of habit. This reflects a sensible approach: trust the automation but always verify the results.

Frequently Asked Questions (FAQ)

Is the WP Engine site migration plugin free?

Yes, the plugin is completely free for all customers with an active WP Engine or Flywheel hosting account. There are no hidden fees or limitations on the number of migrations you can perform.

Will my website experience any downtime during the migration?

No, the migration process itself does not cause downtime. The plugin creates a copy of your site on the new server while your original site remains online and fully functional. The only potential downtime is the brief period (from minutes to a few hours) when you update your DNS records and they are propagating across the internet.

Can I use this plugin to move my site to another host besides WP Engine?

No, this plugin is specifically designed to migrate websites to WP Engine and its sister company, Flywheel. It will not work for migrating to other hosting providers, as it relies on WP Engine's specific server configuration and API access.

What if my site is too large for the plugin to handle?

For extremely large or complex sites, the automated plugin might time out. In these cases, WP Engine's support documentation recommends alternative methods, such as migrating via WP-CLI (if you have command-line access) or performing a manual migration. You can also always reach out to WP Engine's award-winning support team for guidance on the best approach for your specific site.

Final Thoughts

Moving a website is a critical task, but it doesn't have to be a source of stress. The WP Engine Site Migration plugin stands out as a powerful, reliable, and user-friendly solution for anyone transitioning to the WP Engine platform. It successfully automates a complex process, making high-performance managed WordPress hosting accessible to everyone, regardless of their technical expertise.

By following the steps and best practices outlined in this guide, you can confidently manage your own site migration. From preparation and execution to post-migration checks, you now have a complete roadmap for a successful move. The combination of this excellent tool and WP Engine's robust platform provides a solid foundation for your website's future growth.

If you're ready to experience superior speed, security, and support, the migration process is your first step. Check out WP Engine's hosting plans to find the perfect fit for your website.

Share This Article