Scope: Prime Mover Free / Pro version

Do I need to adjust my PHP upload parameters for large packages?

This is not required. Prime Mover is designed to cope up with limited PHP upload parameters. So even if your package zip size is 60 MB and your server PHP max upload file size is only 2MB (PHP default). Prime Mover will automatically slice your package to 2MB upload sessions until its uploaded completely.

Do I need to adjust my server timeout settings for large packages?

Most hosting servers we tested can cope up even with default timeout settings for most websites. So this is not strictly required. However in some hosting companies, they impose server side limits that terminates request when a time out is reached. Prime Mover can appear freeze on the client browser (not progressing or a process stuck for too long – we will fix this in future releases). If you happen to observe this, try asking your web hosting to increase the timeout.

If this is not possible; what you can do is to broke down the migration into parts. Prime Mover has native feature for you to do this easily. For example, say the bottle neck of the export process is a very large uploads directory. You can exclude the media files (if you have a PRO version in the export process and then generate a complete export (db + plugins / themes). Then the migrate the uploads folder manually by simply copying it from the source site to target site.

Or if you have a free version only, you can export database and manually move the uploads and plugins. Or if plugin is the bottleneck, move the database and media files with Prime Mover and manually copy the plugins.

What is a debug package?

Debug package is a Prime Mover package without media uploads. This simplifies migration. An ideal solution for developers needing to clone/migrate a site for WordPress debugging.

Does the free version be able to handle very large sites?

Yes, however the maximum size supported in free version is 4GB (total zip size of a complete package that includes dB + media + plugins/themes). This is mostly related to browser upload limits. Prime Mover will validate and notify you if the package size is too much for the browser to handle. In this case, you should manually upload this package to your server (via SSH). Once uploaded, get the URL to the zip and use the Prime Mover remote URL restore feature (Pro version). If browser can accept the uploads (e.g. between < 4GB but still very large). It is now recommended to increase the size your server upload and timeout parameters to speed up the process. Otherwise the restoration will be very slow.

Is there any way to speed up the migration process for default upload restoration?

If your package is hosted on third party sites like other websites or in cloud services like Dropbox, Google drive, etc. You can use the PRO feature “Remote URL restore” feature. This will speed up the process since it will fetch the zip package URL directly from the source and download it directly to your site. No need to download to your Desktop and upload again ! But if the source package is located in your local Desktop and you want to migrate it to remote site. There are three approaches you should do to speed-up the export if you can tweak these settings:

  • Use large upload_max_filesize (ideally 16MB + ) in your target site.
  • Make sure your Internet connection provides the fastest upload speed possible to your remote site.
  • Use Prime Mover version 1.0.3 above.

Does the free version be able to restore encrypted packages created by the Pro version?

Yes, but it is required that the target site uses the same key used to encrypt the package at the source site. Take note that the free version cannot be used to create encrypted packages but it can restore encryted packages.

Why I’m only be able to restore only by uploads

You are using the Free version. In Pro version, you should be able to restore via uploads, remote URL to the zip and restore zip as backup within your server.

How can I exclude some plugins from being included in the migration package ?

The free version does not include a plugin exclusion feature. This is only available in the PRO version.

How can I exclude some media files from being included in the migration package ?

The free version does not include a media files exclusion feature. This is only available in the PRO version.

Is my package secure ?

The free version does not store any zip package in your server. So there is no possibility anyone can download it. However the free version does not have encryption support, so the database and media files are readable by anyone if they can access your zip. In Pro version, there is an optional encryption support that you can use to protect your database and media files. This is highly recommended if data security is a concern.

How does this work in multisites ?

Prime Mover support multisite migrations. This is done only on the network administration pages by super-administrators. Both Free and Pro version does not support giving this privilege to ordinary subsite administrators.

Why is it required to provide blog ID for single site to multisite migration ?

Prime Mover uses this blog ID to validate which site does the package will be restored into. Without blog ID, there is no way to detect the target site.

Any limitations on using this plugin?

Prime Mover does not migrate WordPress users and user meta table. This allows you to migrate sites inside the WordPress admin (current users preserved) and also a more secure migration method. This also allows smooth multisite sub-site to single-site migration and vice-versa without any hassle as the user tables are not overwritten or involved in the process. If you really need to migrate users / user meta table as well, then Prime Mover plugin is not the right plugin to use. In addition, Prime Mover does not migrate WordPress core files (including wp-config.php). This is not necessary since WordPress strongly enforces backward compatibility in it’s core. Prime Mover only migrates the main essentials of a website: database, media files, the plugins and themes being used. In a multi-site, you can only migrate sub-site (one zip package for one site – just like in single site). You cannot use Prime Mover to migrate the main site of a multisite or migrate all sub-sites (or entire network) in a single zip package.

Is this PHP 7.0+ compatible?

Yes, PHP 7.0+ is highly recommended if your hosting supports it.

While restoring a site I got log-out, is this normal?

Yes, sometimes when restoring a database it can take some time for some lines to be inserted. WordPress will show intermittent log-out warnings when on the process of restoring dB. You should not terminate/refresh the process and wait until its done. You can click “x” on the sign-in pop-up window to close and things will go back as logged-in as usual.

Update: in version 1.0.3+ we added a fix on this issue so you should not see this glitch very often.

I saw some errors being logged during migration, do I need to panic?

No. Due to complex nature of restoration, you might see random errors as the site is not fully migrated yet. This is usually normal if the site does not encounter fatal runtime errors. It is recommended to wait until the migration is completed and check the visual and functionality results of the site. If the site appears broken, its time to look into these errors in detail.

I saw some 404 errors after migration. do I need to worry?

No. You need to refresh the permalink by logging-in to your `WordPress admin -> Settings -> Permalinks` . Simply click save (do not change any settings). This should resolve most 404 issues.

The site got locked in maintenance mode. How to get out of maintenance mode?

This usually happens if you forcefully terminate any running export/import process or server encounters glitch. Assuming this is entirely caused by Prime Mover plugin (not WordPress core maintenance or any plugin/theme updates). You can run this URL (make sure you are logged-in):


Replace yoursiteurl.tld with your site domain and 1 with the blog ID of the site. This is usually 1 for single-site installation or greater than 1 in multisite. Then refresh again, the maintenance mode should be removed. If you happen to be logged-out, you should manually delete the option named as prime_mover_maintenance in the WordPress database options table.

Update: In version 1.0.3+ we added a link to administrators to disable maintenance mode. So, pasting them in the browser address bar is no longer necessary.

Can I deactivate or remove Freemius?

No. We use Freemius as a licensing platform for the plugin pro version. It’s included in the free version, so any users can easily upgrade to PRO version. You can choose to un-subscribe to any communications by Freemius after you have activated the free version. Just click “Skip” in the opt-in dialog. Freemius will not slow down your site or harvest for personal details without your permission. If you have any questions related to Freemius, feel free to shoot a question to

How can I get support?

There is a community-support for free version of Prime Mover which is hosted in forum. PRO and Free Trial customers can get faster/dedicated technical support through emails. This can be done using the contact form within the plugin admin settings.

Was this article helpful?