Theme & Plugin Files Errors
There are a few potential causes of errors when running a theme and/or plugin files migration.
The first thing to check is directory and file-system permissions. If the web server is unable to write files to the
wp-content/plugins folders the migration will not run. Check out our doc on file permissions for more.
Another potential cause of errors is symlinks. Symlinked theme or plugin folders (or subfolders) will not migrate correctly as the web server is unable to locate the real path of the files being migrated.
Restricted PHP core functions
Another thing to look out for is restricted PHP core functions. Some web hosts don’t allow certain PHP functions to run out of security concerns. The functions required to run a Theme & Plugin Files migration are:
If you get an error message mentioning any of the above functions, follow up with your web host to see if they can be allowed. They are typically listed in the disable_functions section of
We are aware of a restriction on WP Engine that stops the creation executable PHP files via unauthenticated requests. This means that pulling files into a WP Engine site will work, pushing for the time being, will not.
Firewalls and rate-limiting
Another thing to be aware of when running a Theme & Plugin File migration is that when pushing some hosts may rate-limit or block requests from the plugin. This is likely due to a firewall or DOS prevention software. Sending multiple network requests in rapid succession can appear malicious to some firewall software.
If you notice that migrations are failing because either the file size or number of files transferred is not correct, follow up with your host to see if your local server’s IP can be whitelisted with their security measures.
You may notice that running file transfers causes memory exhaustion errors. When running a push we load each file’s contents into memory, so this may be where an error occurs. Please see our detailed doc on memory limits for some options to increase memory usage.