Scope: Prime Mover Free / Pro version

What are the complete list of files migrated or backup?

If you chose complete export mode which is “Export database, media files, plugins and themes.” , it will export the following:

  • Database of your site. (one SQL file), you can encrypt this database in PRO version.
  • All files in your wp-content/uploads directory for single site or wp-content/uploads/sites/[blog_id] for multisite subsite. You can exclude files in PRO version. You can also choose to encrypt all these media files in PRO version.
  • All activated plugins for that site (this includes network activated plugins if you are in multisite). You can exclude these plugins in PRO version for both single-site/multisite. Plugin files can be encrypted for best security in PRO version also.
  • The current activated theme of the site(parent theme or parent theme + child theme if both are used). In PRO version, you can choose to encrypt BOTH parent and child themes for best security.

It does not currently include the following:

  • WordPress core files. This is not needed since most WordPress installations assumes to be using latest version for security reasons.
  • All files outside your WordPress installation, for example you have custom directory created outside your WordPress installation that is NOT on the site uploads directory. In the future release, this might be considered to be added in PRO version.
  • wp-config.php of the site. – this is not needed since it will use the wp-config.php of the target site always.
  • .htaccess or any other server configurations (such as in nginx, etc.) – this is not needed also since it will always use the target site server configurations for maximum compatibility.

How to restore large packages using Free version?

Please read this tutorial for details.

Does this plugin works in localhost?

Yes, of course. You can migrate or do backups at localhost. And then migrate to remote server and vice versa.

Does this plugin works with any hosting companies?

Yes. Also this plugin supports both Linux and Windows server environment.

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 size is 60 MB and your server PHP max upload file size is only 2MB (PHP default, and you are on shared hosting- cannot change).

Prime Mover will automatically slice your package to 2MB upload sessions until its uploaded completely. It even checks if you have slower connection, it even slices it lower as your connection can only allow without sending too much to the server.

However we recommend the following for best upload experience (especially for those migrating or upload very large packages):

  • Fastest upload speed connection you can obtain.
  • If you can change upload_max_filesize and post_max_size (or if your hosting allows to change this for your site). Set them as high as possible as your server can allow.
  • Upgrade to PRO version if you are restoring a very large site (e.g. >300MB package size) especially if you are on a slow upload connection and will not be able to change any server settings. PRO version offers more solutions in case you will have upload issues in the FREE version.
  • If upload would still take a very long time, please consider this solution.

IMPORTANT: If you restore via upload in a local server (e.g. localhost), it is recommended to change the upload_max_filesize and post_max_size parameters as high as possible so your upload will complete as soon as possible. Since you are in a local server, you should be able to control these settings. If you are in a remote web hosting that you can also control, its good to change these settings as advised previously. Your upload will complete faster.

I got runtime error “Main extraction Failed: No error” in Windows / Microsoft IIS, what’s the workaround?

This is caused by some Windows limitation relating to the number of characters in the file path (path inside package included). Please read this guide for the complete workaround and solution.

I want to avail free trial or purchase a license, how many licenses do I need?

First, we thank you for the interest in planning out to purchase a plugin license. It helps the plugin author find a sustainable livelihood!

We always recommend to start with 4-sites license if you are migrating in and out of a WordPress multisite to single-site or vice versa. If your migration involves any multisite implementations, please start with a 4-sites license.

This is the most flexible license to use that should work whether you are planning to use the plugin in a single-site or multisite platforms.

If you are really sure that you are only dealing with one WordPress single-site. (no multisites at all or multiple single-site in different hosts!), then you can start with a single-site license only. This will work only for one single site and should not be used with multisite or several single -sites.

If you are into WordPress site development business, web agency, pro-site developer/designer, that is migrating/developing/deploying large number of sites regardless it is multisite or single site, then we recommend unlimited site license. This way, you are not restricted with the number of sites and you can install the license in any number of sites you need to use.

For more details, please read the Prime Mover licensing guide. Click this link if you like to try the 14-days risk free trial.

Do I need to adjust my server timeout settings for exporting or restoring very large sites?

No. If you are using version 1.0.7+ and if your server has these PHP core functions enabled:

  • escapeshellarg
  • shell_exec
  • popen
  • exec

This will allow Prime Mover to run time-intensive task in PHP-CLI environment which is not subjected to HTTP web server timeout (except server memory limitations in some hosts, e.g. in shared host).

If you don’t have these functions enabled and you are getting timeout errors, please read this guide on migrating large sites and see if adjusting a timeout works for you as well as other solutions.

I got errors that wp-config is not writable ?

Prime Mover requires wp-config.php to be writable. To make this writable, you can run this command if you have SSH root access:

sudo chmod 664 wp-config.php

You need to run this command on your WordPress root on the directory where wp-config.php is found.

ERROR: Shell process terminated = by your web host due to insufficient resources ?

Quick workaround is to enable non-shell mode by adding this to your wp-config.php:

define('PRIME_MOVER_SLOW_WEB_HOST', true);

If this still does not work, please create a bug report ticket.

Update: This should no longer be the case in version 1.1.5 +

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.

Debug package is not recommended for migrating complete sites (which means working/stable images, etc.). It does not handle images like it was in stable sites. This is only used for debugging/troubleshooting purposes.

What is WPRIME file extension / archiving format?

Since version 1.1.5, Prime Mover archives using WPRIME file extension. This is a derivative of the Linux tarball (.tar) format and follows it’s specifications. It’s customized to fit Prime Mover special archiving needs such as encryption, decryption, file integrity checks and storing special file meta that is used during archiving.

This is more robust archiving format and performs better than the previous zip archiving format.

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

Yes, actually supposing you have a fairly fast hosting server and you have ample of hosting resources available (CPU, memory, etc.). Prime Mover should have no issues exporting big sites even up to several GB’s even using free version.

And that supposing you also have a a super-fast upload connection speed (e.g. 100 MBPS upload speed – please check with speed test), Prime Mover should also have no issues uploading it to your target site. This is recommended up to 3.5 GB only. It is because of browser limitations, as some browsers will have issues uploading very large files.

If you fall into these following scenarios:

  • Slow upload connection speed.
  • Slow target site hosting server. (e.g. limited shared host that restricts file size)
  • Your package size is beyond 3.5 GB.

Then the best solution is to manually upload package and then restore within Prime Mover package management page (in WordPress admin).

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 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. You can upload that package using SFTP client (e.g. Filezilla) and restore it via Prime Mover backup manager.

If browser uploading is your only option (e.g. in Free version). There are three approaches you should do to speed-up the upload if you can tweak these settings:

  • Use large upload_max_filesize (ideally 32MB + ) in your target site.
  • Use post_max_size ideally about 4 times your set upload_max_filesize. So if you set upload_max_filesize to 32MB, set your post_max_size to 128MB.
  • Make sure your memory_limit is around the same or greater than post_max_size
  • Make sure your Internet connection provides the fastest upload speed possible to your remote site.
  • Use latest version of Prime Mover.

If you cannot change any of these settings or that its is very difficult and restricted, please read this tutorial.

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

No, you need the PRO version to restore encrypted packages.

Why I’m only be able to restore only by uploads or via backup page

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

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 saves the package path at your Prime Mover backup directory with randomized file names. This is also protected with .htaccess in Apache. So there is no direct way for anyone to 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 package. In Pro version, there is an optional encryption support that you can use to protect your database, media files, plugin and theme files. Also in Pro version , you can move the backup directory outside the web root. This is highly recommended if data security is a concern.

How does this work in multisites ?

Prime Mover support multisite migrations (including FREE versions). 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.

The migration mode can support (available in both Free and Pro version):

  • Single-site migrate to Single-site
  • Single-site migrate to Multisite sub-site
  • Multisite sub-site migrate to another Multisite sub-site (even using different blog IDs)
  • Multisite sub-site migrate to Single-site.

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 sub-site in multisite.

Any limitations on using this plugin?

In a multi-site, you can only migrate sub-site (one 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 package. This limitation is added on our feature list and will be added in the future release.

If you are on a shared hosting and you are migrating very big sites, it can be very slow. As the plugin is limited by the resources provided by your shared host (CPU, memory, requests ,etc). Sometimes these shared hosts are very restrictive in resources that makes it unable to complete export or import for even any migration plugins . Even WordPress core operations itself like installing or updating big plugins from repository- you will get errors). That is why it is always recommended nowadays that you switch to a VPS, managed hosting or dedicated hosting to meet the demands of your large site.

Is this PHP 7.0+ compatible?

Yes, PHP 7.0+ is highly recommended if your hosting supports it. PHP 7.4+ is the fastest currently (as of January 2020) based on our testing. We recommend using this one if all of your plugins supports it.

We don’t anymore recommend using PHP 5.6 as its outdated, slow and not anymore suggested by WordPress (in fact you should see upgrade PHP notice in recent WordPress updates). Prime Mover still runs on PHP 5.6 (as of January 2020, a lot of sites are still using this). But will be deprecated in the near future, so please upgrade your PHP version.

While restoring a site it freezes and no longer provide progress, is this normal?

Your internet connection might have been disconnected while you are doing export or restore. As a result, the JS progress update is cut off (as it communicates from your browser to the server). Please clear browser and make sure your connection is stable then try again.

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?

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. If you happen to be logged-out, you should manually delete the option named as prime_mover_maintenance in the WordPress database options table.

If you are on a multisite, manually delete the .maintenance file just like any stalled WordPress updates.

I got error “Fatal error: Cannot declare class WPConfigTransformer” when activating Prime Mover?

This is caused by a third party plugin conflict. You have activated a plugin that loading the WP Cli WpConfigTransformer class incorrectly. Actually this is a third party PHP library and should be added as plugin dependencies using a PSR-4 composer autoloader for maximum compatibility.

Solution: Try deactivating that plugin in conflict temporarily and then activate Prime Mover. And for permanent fix, please report that to the plugin developers for fixing.

Error: Wrong import site package! Please check that the import package is correct for this site.

This is caused by incompatible restore package. For example, you restore a single-site package to multisite server or vice versa. Or you restore multisite package that is intended for another sub-site blog ID.

To fix this issue, make sure that:

  • If you want to migrate to WordPress single-site, make sure you create a single-site export and restore that single site package to any WordPress single-site only. For example, make sure this is checked during export:

And then restore this package ONLY to single-site.

  • If you want to migrate to WordPress multisite subsite with blog ID (e.g. 7), make sure to create a multisite package targeting blog ID 7. And restore that multisite package to only to subsite blog ID 7. For example, you need to check export to multisite format and provide 7 as the blog ID, e.g.

And then restore this package only to the multisite sub-site with blog ID 7.

It does not matter if you are creating these packages at single-site or multisite. The only thing that is important is you created the correct package for your target destination (by providing correct export type) (single site package for single site destination or multisite package for multisite destination)

Who is Freemius? Can I deactivate or remove Freemius?

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.

If you want to send sensitive details to the plugin author only, please do so by using our contact page.

You can also ask questions via Facebook messenger app that is available on this website.

What is your support policy?

It’s here.

What is your refund policy?

You are fully protected by our 100% Satisfaction Guarantee. If over the next 30 days you are unhappy with our plugin or have an issue that we are unable to resolve, we’ll happily consider offering a 100% refund of your money.

Once we receive a refund request within the valid refund period due to one of the following reasons:

  • The plugin isn’t working as expected (with explanation).
  • Missing feature(s).
  • Technical issue (including conflicts with other plugins and/or themes).

We will do our best to resolve the issue or find a workaround. If we can’t resolve it, we will process a refund.

Note: Customers who just changed their mind or can’t provide a reasonable explanation for the refund inquiry are not covered by the refund policy and will not be eligible for a refund.

Please read the refund policy details here.

If you are considering upgrading to a PRO version but still have some doubts, please avail our 14-day risk-free trial. This way you can evaluate the plugin’s PRO features at no risk.

Where can I ask Pre-sales Questions?

You can ask questions before you buy. This is recommended so we will know whether Prime Mover is the right solution for your problem.

This is the link to our pre-sales questions page.

Was this article helpful?