How to Use the WP Engine Site Migration Plugin: A Step-by-Step Guide

By
23 Min Read

How to Use the WP Engine Site Migration Plugin: A Step-by-Step Guide

Moving a WordPress website from one host to another can feel like a daunting task, filled with technical hurdles and the risk of downtime. The process often involves manually handling databases and files, which can be complex for even experienced users. The official wp engine site migration plugin is designed to eliminate this stress, offering a streamlined, automated path to transfer your site to their powerful managed hosting platform. This guide will walk you through every step of the process, from preparation to going live.

This tool, also known as the WP Engine Automated Migration plugin, is provided free of charge to all customers. It securely copies your entire WordPress installation—including your themes, plugins, media, and database—without affecting your live site. By following a clear, guided process within your WordPress dashboard, you can ensure a smooth and error-free transition to your new hosting environment.

What You'll Learn

  • What the Plugin Is: The WP Engine migration plugin is a free, purpose-built tool that automates the process of moving any WordPress site to a WP Engine or Flywheel hosting account.
  • Key Benefits: It offers a secure, fast, and user-friendly migration that requires no technical expertise, minimises human error, and ensures your original site remains online throughout the process.
  • The Step-by-Step Process: This guide details the entire migration, from preparing your old site and finding your credentials in the WP Engine portal to running the plugin and verifying the transfer.
  • Troubleshooting Tips: Learn how to solve common issues like failed connections or stalled migrations, ensuring you can handle any bumps along the way.

Understanding the WP Engine Migration Tool

The WP Engine Automated Migration plugin is a specialised piece of software created by WP Engine for one specific purpose: to make moving to their platform as simple as possible. Unlike general-purpose migration plugins that work with any host, this tool is finely tuned for the WP Engine and Flywheel server environments. This specialisation is its greatest strength, as it guarantees a high degree of compatibility and reliability.

When you use the plugin, it establishes a secure connection between your current website (the source) and your new, empty WordPress installation on WP Engine (the destination). It then systematically packages your entire site—the wp-content folder containing your themes, plugins, and uploads, along with a complete copy of your database. This package is then transferred and unpacked on the WP Engine server, effectively creating a perfect clone of your original site.

wp engine site migration plugin

wp engine site migration plugin

One of the most critical functions it performs is automatically handling the search-and-replace process on the database. WordPress stores your site's URL in many different database tables. When moving to a new host with a new domain or temporary URL, these references must be updated. Doing this manually is tedious and prone to error.

The site migration plugin for WP Engine automates this entire task, ensuring all internal links and asset paths work correctly on the new server from the moment the migration is complete.

Key Features and Benefits of the Official Plugin

Choosing to use the official WP Engine transfer plugin over manual methods or third-party tools comes with a host of advantages designed to save you time and prevent headaches. The entire experience is built around simplicity and reliability, making it the recommended choice for anyone moving to the platform.

Core Features That Simplify Migration

  • Automated Full-Site Cloning: The plugin doesn't just move files; it creates an exact replica of your site. This includes all posts, pages, user accounts, plugin settings, and theme customisations. You don't have to worry about missing a crucial file or database table.
  • Intelligent URL Handling: It automatically detects your old and new URLs and updates them throughout your database. This prevents the common issue of mixed content warnings or broken images after a move.
  • Secure Data Transfer: The connection between your old site and the WP Engine server is encrypted, ensuring your website's data is protected throughout the transfer process.
  • User-Friendly Interface: The entire process is managed from a single, simple screen within your WordPress dashboard. There's no need to use complex tools like FTP clients or phpMyAdmin.

Major Benefits for Users

  1. It's Completely Free: Migration services can cost anywhere from £100 to over £500, depending on the complexity of your site. The WP Engine plugin is included with every hosting plan from WP Engine, offering significant value and lowering the barrier to entry for premium hosting.
  2. Reduces Risk of Human Error: Manual migrations involve many steps where things can go wrong—from incorrect database credentials to failed file uploads. By automating these steps, the plugin drastically reduces the chances of an error that could take your site offline.
  3. Maintains Uptime on Your Original Site: The plugin works by copying your site, not moving it in real-time. Your original site remains fully operational and accessible to visitors until you are completely satisfied with the migrated version and ready to point your domain to the new server.
  4. Speed and Efficiency: For most standard WordPress sites, the automated migration process can be completed in under an hour. This is significantly faster than a manual transfer, which could take several hours of active work.

Preparing Your Site for a Smooth Migration

Before you even install the migration plugin, a little preparation can go a long way in ensuring the process is fast and error-free. A clean, up-to-date website is much easier to migrate than one cluttered with old data. Think of it as tidying up your house before the movers arrive.

Step 1: Perform a Full Backup

This is the most important rule of any major website operation. While the WP Engine plugin is very reliable, you should always have a complete, independent backup of your site before you begin. This is your safety net. You can use a trusted backup plugin like UpdraftPlus or WPvivid Backup to create a full backup of your files and database.

Download it and store it safely on your local computer or a cloud storage service.

Step 2: Clean Up Your WordPress Installation

A smaller website migrates faster. Take this opportunity to perform some digital housekeeping:

  • Delete Unused Plugins and Themes: If you have plugins or themes that are installed but not active, delete them. They contribute to the size of your file system unnecessarily.
  • Clear Out Post Revisions: WordPress saves multiple revisions of your posts and pages. Over time, this can add a significant amount of bloat to your database. Use a plugin like WP-Optimize to clean out old revisions.
  • Remove Spam Comments and Transient Options: Empty your spam comments folder and use a database optimisation tool to clear out expired transients. These are temporary options stored in the database that can safely be removed.

Step 3: Update Everything

Ensure your WordPress core, plugins, and themes are all updated to their latest versions on your source site. Running outdated software can sometimes lead to compatibility issues after moving to a new server environment with different PHP or MySQL versions. A fully updated site is more secure and more likely to migrate without any hitches.

How to Use the WP Engine Site Migration Plugin: A Step-by-Step Guide

With your site prepared, you're ready to begin the migration. The process is straightforward and guided at every step. This section provides a detailed walkthrough, complete with explanations of what's happening behind the scenes.

Step 1: Set Up Your Destination Site on WP Engine

Before you can migrate, you need a place for your site to go. Log in to your WP Engine User Portal.

  1. Navigate to the Sites page.
  2. Click Add Site and give your new site a name. Choose whether to start with a blank site or a copy of an existing one. For a migration, you'll start with a new, blank site.
  3. Create a new Production environment for this site. WP Engine will then set up a fresh WordPress installation for you. This will serve as the destination for your migration.

Step 2: Locate Your Migration Credentials

Once the environment is ready, you need to get the credentials the plugin will use to connect to it.

  1. On the Site Overview page in your WP Engine portal, click on the environment you just created.
  2. On the left-hand menu, find the SFTP users link. Click it.
  3. Here you will find the three pieces of information you need: the Hostname (or IP Address), the Username, and the Password. Keep this page open, as you'll need to copy and paste these details shortly.

Pro Tip: The SFTP password is automatically generated by WP Engine and is very secure. Use the 'copy' button next to each credential to ensure you don't make any typos when transferring them to the plugin.

Step 3: Install the Plugin on Your Source Site

Now, go back to the WordPress dashboard of the site you want to move (your source site).

  1. Navigate to Plugins > Add New.
  2. In the search bar, type “WP Engine Automated Migration”.
  3. The plugin should appear as the first result. Click Install Now, and then Activate.

Step 4: Start the Migration

After activation, you'll see a new Site Migration tab in your WordPress admin menu. Click on it to open the migration dashboard.

  1. You'll be presented with a simple form. First, enter your email address. The plugin will send you notifications about the migration status.
  2. Next, carefully copy and paste the Hostname, SFTP Username, and SFTP Password from your WP Engine portal into the corresponding fields.
  3. Click the Migrate button. The plugin will first validate your credentials. If they are correct, it will begin the migration process.

Step 5: Monitor and Verify

The plugin will show you a real-time progress screen, letting you know which stage it's at (e.g., backing up the database, transferring files). The time this takes depends entirely on the size of your site—from a few minutes for a small blog to over an hour for a large e-commerce store.

Once complete, you will receive an email notification. Now it's time to check the cloned site. WP Engine provides a temporary URL for every environment (e.g., yoursitename.wpengine.com). Visit this URL and browse the site thoroughly.

Check your pages, posts, images, and contact forms. Test the functionality of any key plugins to ensure everything works as expected.

Step 6: Go Live

When you are confident that the migrated site is a perfect copy, it's time for the final step: pointing your domain to WP Engine. This involves updating your domain's DNS records at your domain registrar (like Namecheap, GoDaddy, or Google Domains). You will need to change your A record to point to the IP address provided in your WP Engine portal. After the DNS changes propagate (which can take a few hours), your domain will load your new site from WP Engine's servers.

wp engine site migration plugin

Troubleshooting Common Migration Problems

While the WP Engine migration tool is highly reliable, issues can occasionally arise, often due to settings on the source server. Here’s how to handle the most common problems.

Issue: The Migration Fails or Stalls

If the migration progress bar gets stuck for a long time or you receive a failure notification, it's often due to resource limits on your old hosting plan.

  • Cause: Shared hosting plans often have strict limits on CPU usage, memory (RAM), and script execution time. A large migration can exceed these limits, causing the host to terminate the process.
  • Solution: Contact your old host's support team and ask them to temporarily increase the max_execution_time and memory_limit for your site. Alternatively, some security plugins can interfere with the connection; try temporarily deactivating them and running the migration again.

Issue: “Could not connect to server” Error

This error appears right after you enter your credentials and click 'Migrate'.

  • Cause: This is almost always due to incorrect SFTP credentials. A single typo in the hostname, username, or password will prevent the connection.
  • Solution: Go back to your WP Engine portal and very carefully copy and paste each credential again. Pay close attention to avoid capturing any extra spaces before or after the text. Also, ensure your source host's firewall isn't blocking outbound connections on the port used for SFTP (port 22).

Issue: The Plugin Doesn't Support Your Site (e.g., Multisite)

  • Cause: The automated plugin has limitations. A significant one is that it does not support the migration of WordPress Multisite networks. It is designed for standard, single-site installations.
  • Solution: If you have a Multisite network, you will need to request a manual migration from the WP Engine support team. They have the expertise to handle these more complex transfers, though it may not be a free service depending on your plan.

Pricing and Costs: Is the Plugin Really Free?

Yes, the WP Engine site migration plugin is completely free to use for all customers with an active hosting plan on WP Engine or Flywheel. There are no hidden fees, data caps, or limits on the number of migrations you can perform. This is a significant value-add that sets premium managed hosts apart from budget providers.

Consider the alternatives. A manual migration, if you hire a developer, can easily cost several hundred pounds. Premium all-in-one migration plugins like Duplicator Pro or All-in-One WP Migration have paid tiers that can cost between £50 and £200 for a licence. By providing this powerful tool for free, WP Engine removes a major financial and technical barrier for customers wanting to join their platform.

This free tool underscores the 'managed' aspect of their service. They aim to handle the technical complexities of hosting so that you can focus on building your website. A smooth, free, and easy migration process is the first step in that customer experience.

Pros and Cons of the WP Engine Migration Tool

No tool is perfect for every situation. Being aware of both the strengths and weaknesses of the WP Engine migration plugin helps you set the right expectations.

Pros

  • Unbeatable Cost: It's 100% free with your hosting plan, saving you significant money compared to paid services or plugins.
  • Ease of Use: The interface is designed for absolute beginners. If you can install a plugin, you can migrate your site.
  • Guaranteed Compatibility: Because it's made by WP Engine, you can be confident it will work seamlessly with their server architecture.
  • Speed and Automation: It automates dozens of manual steps, making the process fast and reducing the chance of errors.
  • Excellent Support: If you run into an issue, WP Engine's award-winning support team is familiar with the tool and can help you troubleshoot.

Cons

  • Platform Specific: The plugin only works for migrating to WP Engine or Flywheel. You cannot use it to move your site to another host or between two non-WP Engine servers.
  • Limited Control: It's an all-or-nothing tool. You cannot choose to migrate only specific files, database tables, or parts of your site. It clones everything.
  • Not for Multisite: It does not support WordPress Multisite installations, which require a manual migration process.
  • Dependent on Source Host: Its success can be hampered by very restrictive shared hosting environments that have low resource limits.

Frequently Asked Questions (FAQ)

Here are answers to some of the most common questions users have about the WP Engine migration process.

How long does a site migration usually take?

The duration of a migration depends almost entirely on the size of your website, specifically the total size of your files and the database. A small blog might take only 15-20 minutes. A larger site with thousands of high-resolution images or a big e-commerce product database could take several hours. The plugin provides a progress bar so you can monitor its status.

Will my website experience any downtime?

No, your original (source) site will remain live and accessible to the public throughout the entire copy-and-transfer process. The only potential downtime is during the final step when you update your DNS records. This period, known as DNS propagation, is typically very short, often just a few minutes, but can sometimes take a few hours to complete globally.

Can I use this plugin to move a site from a local server?

Generally, no. The WP Engine migration plugin requires the source site to be on a publicly accessible web server with a domain name. It cannot connect to a localhost environment on your personal computer because the WP Engine servers have no way to reach it over the internet. To migrate a local site, you would first need to deploy it to a live staging server.

What happens if my website is extremely large (e.g., over 20GB)?

The plugin is capable of handling very large sites, but the process can be slow and is more likely to run into server timeouts on the source host. For exceptionally large or complex websites, WP Engine recommends reaching out to their support team. They can assess your site and may recommend a more direct, server-to-server manual migration performed by their experts to ensure a smooth transition.

Does the WP Engine transfer plugin move my email accounts?

No, this is a crucial point to understand. The plugin migrates your WordPress website only. It does not handle email accounts. WP Engine is a specialised WordPress host and does not provide email hosting.

You will need to keep your email hosting with your domain registrar or use a dedicated service like Google Workspace or Microsoft 365.

Final Thoughts

For anyone moving a standard WordPress site to WP Engine, their official migration plugin is unquestionably the best tool for the job. It transforms a potentially complex and stressful technical task into a simple, automated, and guided process that anyone can follow. By eliminating the need for manual file transfers and database edits, it saves time, reduces risk, and starts your journey on their platform on the right foot.

The combination of its user-friendly design, the security of the transfer, and the fact that it's completely free makes the wp engine site migration plugin an invaluable resource. It embodies the core promise of managed WordPress hosting: letting the experts handle the technical details so you can focus on growing your business or creating content.

If you're ready to make the move to a faster, more secure hosting environment, you can be confident that the transition will be the easiest part of the process. For more details on their plans and features, you can visit WP Engine to get started.

Share This Article