When WordPress refuses to upgrade it is usually because of one of the following reasons:
- The WordPress upgrade directory is inaccessible
- The PHP version is below 5.x
- WordPress was installed using Fantastico
- A plugin is preventing the WP upgrade
- The PHP memory limit or max script execution time
Other, less common reasons include:
- You’re doing it all wrong
- WordPress doesn’t like you
- WordPress is in a bad mood, or
- It’s just not your day
The less common reasons are easy to fix: take a break, have a drink and return to the website tomorrow. Sometimes it just isn’t meant to be.
If taking a rest is not an option and you are on a deadline to bring WordPress up to date, then read on and follow the guided steps to fixing WP version upgrade problems.
Check WordPress has permission to write to the upgrade directory
- Login to cPanel
- Open the file manager
- Navigate to wp-content
- Check the read-write permissions for the upgrade directory are set to 755 (or 777 for some servers)
- Try to upgrade WordPress again
Make sure the server uses PHP version 5.x
The auto upgrade feature requires WordPress to be installed on a server running PHP 5.x or above. Check your PHP version.
- Login to cPanel
- Click PHP Configuration
- Select PHP 5.x then save the setting
- Try the WordPress upgrade again
If you need to force PHP5.x to be used:
- Open your FTP program of choice or cPanel file manager
- Navigate to the public_html (the root directory where WordPress is isntalled)
- Open .htaccess
- Add the following line to the top of the file
- Save .htaccess
- Try to auto update WordPress again
Was WordPress installed using Fantastico?
Fantastico is a software installer script used on some web servers. Fantastico can be used to install WordPress with minimal effort. Fantastico can be used by clicking the ‘Fantastico’ icon in cPanel.
If your WP site was installed with Fantastico you will see upgrade notices when you open the Fantastico admin panel. Some versions of Fantastico prevent WordPress core software upgrades from taking place unless initiated through Fantastico.
- Click Fantastico Delux
- Check whether there is a WordPress script update notice in the Fantastico admin panel
- If there is no such notice in Fantastico you can discount Fantastico as being the problem. Skip ahead to the next solution. Otherwise..
- Use a file manager to browse the WordPress installation directory
- create a backup of wp-config.php
- create a backup of .htaccess
- Create a directory called backup then copy (do not move, just copy) the wp-content directory to the backup directory
- Run the Fantastico updater
- Check that your WordPress site works as expected. If the site works properly you can remove the backup files. If the site does not work properly, restore wp-config.php and .htaccess from the backups. If the site still doesn’t work properly, restore the wp-content directory from the backup.
Are plugins preventing WordPress upgrades?
This is easy to test and fix:
- Disable all plugins
- Try the upgrade again
- Re-enable all plugins
Badly out-of-date plugins tend to be the ones that prevent upgrades and update notices.
The PHP memory limit and script execution time limit are too low
To ways to try fixing this:
- Ask your host to increase your PHP memory limit, or
- Open cPanel and open php.ini QuickConfig (sometimes called php.ini EzConfig) then raise your PHP memory limit. Check with your host for your hosting plan’s highest allowed PHP memory limit.
Over to you
How do you get WordPress to auto upgrade when it stubbornly refuses to budge from its current level?