In this article, we have listed some limitations likely to cause the 1-click WordPress migration to fail and explain what you can do to solve a failed migration.
- The current .htaccess file will be replaced with the default .htaccess file from the WordPress installation. If you have added custom settings to the .htaccess, you will need to add them again after completing the migration.
- Migration of Multisite is not yet supported and can cause the migration to fail.
Remove the failed migration
- Go to your WordPress installations page in the WP dashboard of your control panel.
- Locate the failed migration.
- Click the three dots next to the status information.
- Click on Delete.
- Enter your control panel password to confirm.
- You can now retry the 1-click migration or start a manual WordPress migration.
Common error messages or issues
Some of the most common error messages or issues and the solutions to resolve them are listed below.
Migration plugin needed - Connection Error
Due to a missing migrator plugin, no connection to the source website could be established.
How to fix it: If you encounter this error message, make sure to install and activate the required plugin on your HOST domain, not on your TARGET domain. To get the plugin, click on the button provided in the message. Remember to both install and activate it to resolve the issue properly.
SFTP can’t establish a connection
The most common reasons are these:
- Password is incorrect
How to fix it: You can verify it using an SFTP client such as Filezilla.
- Domain/website redirects
How to fix it: First, check for any web forwards, web aliases, etc, on either of the two domains. Following that, look at whether you are using the default A records or have created custom ones. Finally, check your browser to confirm if the domains are redirecting.
Migration fails without any clear reason
The website you are trying to migrate has to return a "200 status code", which means that the server successfully processed the request and everything is working as it should. Whereas a "500 error" or a "404 error" will cause issues and likely make the migration fail.
How to fix it: Ensure that both domains and the website you want to migrate are working. Before migrating, it is often helpful to disable all plugins.
If you're still experiencing difficulties, please feel free to reach out to our support via chat or email. It's actually helpful to prepare the following answers in case they are needed to troubleshoot.
Questions supporters could ask you:
- Migrating from existing location (= source website URL):
- Migrating to the new location (URL):
- Which method are you using? Is it our 1-click migration tool, or maybe a manual migration?
- If you are experiencing problems: What error message do you get and where? (Screenshots are always helpful)
- We might ask you for your Server Login details if we need to recreate the problem. This information includes the hostname, username, password and port for the source website. If you are migrating a website within one.com and are not sure what your SSH or SFTP details are, we have created the following guides to help you find them:
Note: If your WordPress source site is hosted externally and you are not sure what server details to enter, please contact the hosting provider where your site is currently hosted.