Your ultimate checklist for Theme Installation error
The good thing about this kind of WordPress errors is that they’re easy to identify. Usually, there’s an error message that accompanies each failure to load, so there isn’t as much troubleshooting. But we know it’s just so annoying, we know downright.
So, here are the most common reasons why your WordPress plugin or theme won’t install and what to do about them:
- Typically, you’ll encounter an installation error during the manual upload of a theme or plugin through the Add New / Upload option in WordPress (as opposed to directly installing from the WordPress repository). Before you get in touch with the plugin or theme developer, verify that you didn’t receive the correct file from them
- Missing file error: This means that the files contained within the folder are not what WordPress was expecting.
Unzip the folder and review the contents. Is this even the correct zip? Does it contain all the files you would expect a plugin or theme to have? You can cross-check the contents of the folder against WordPress’s recommendations for files that should be included in the package:
A WordPress plugin package.
A WordPress theme package.
If you’ve detected any missing files, reach out to our support team for assistance.
- Missing stylesheet error: In reality, the stylesheet is not missing. You must have probably downloaded the wrong version of the theme file. WordPress can unzip the top-level zip file, but it won’t be able to go through and unzip everything else contained within the folder. If you want to get your theme in there, then you need to upload the proper zip file.
- Memory limits are exceeded: Generally, this happens when your web hosting PHP memory limit is too low to process the installation.
The error will say something like, “Fatal error: Allowed memory size of _______ bytes exhausted…” If you see this memory error, it’s easy to fix.
Log in to the control panel of your site and open your preferred file editor: FTP or file manager. In the root directory, you’ll find your wp-config.php file. Click on the edit button and add the following line of code:
define( 'WP_MEMORY_LIMIT', '256M' );
Since the default memory limit is usually 64M, this will significantly increase it and help you get your new theme or plugin installed without issue.
- File size limits are exceeded: To fix this maximum upload limit, you’ll need to do so through the control panel. Access your directory using either FTP or a file manager. Once you’re in there, locate the wp-admin folder.
upload_max_filesize = 1000M
post_max_size = 2000M
memory_limit = 3000M
file_uploads = On
max_execution_time = 180