WordPress Won’t Update!!! What Do I Do?

Being a WordPress developer, I often meet WordPress sites that do not auto update. There are four main reasons WordPress will not update:

  1. The upgrade folder has the wrong permissions set
  2. Its server’s PHP is below version 5
  3. WordPress was installed using Fantastico or something similar
  4. A plugin is preventing upgrades
  5. The server has a very low PHP memory limit

Other, less common reasons include:

  1. You’re doing it all wrong
  2. WordPress doesn’t like you
  3. WordPress is in a bad mood, or
  4. 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. The more common reasons are not much harder to fix.

Fixing Common Reasons WordPress Will Not Upgrade

The Upgrade Folder Has The Wrong Permissions

  1. Access your server directory structure using FTP or your host’s file manager
  2. Navigate to wp-content
  3. Change the permissions on the upgrade directory to 755 (or, on badly configured servers, 777)
  4. Run the auto upgrade again.

Its Server’s Php Is Below Version 5

The auto upgrade feature requires WordPress to be installed on a server running PHP 5 so check your PHP version.

  1. Log into cPanel
  2. Click PHP Configuration
  3. Select PHP5 then save
  4. Try the upgrade again

If you need to force PHP5 to be used:

  1. Browse your server’s file structure
  2. Navigate to the directory WordPress is installed in. It will be the directory that contains wp-config.sample
  3. Open .htaccess (make sure dot files are visible)
  4. At the top of the file, add the line
  5. Save .htaccess
  6. Try to auto update WordPress again

If the upgrade shows you a file’s contents, remove the above line from .htaccess. Your server won’t allow you to set the PHP file type handler.

WordPress Was Installed Using Fantastico Or Something Similar

This is the most common reason: a dodgy web developer or a novice web developer used Fantastico or some other host provided script to install WordPress. You will know whether this is the case when you visit the Fantastico software installer page and it tells you that you need to upgrade scripts.

Fantastico has a nasty habit of overwriting parts of the wp-config.php script used by WordPress to store its database name, database user name, database user password, database location and database prefix. The Fantastico upgrade process is simple but follow these precautions first. It butchers the .htaccess file by stripping empty lines from it.

From cPanel:

  1. Click Fantastico Delux (or whatever your host provided software installer is called)
  2. If it says you have scripts to upgrade, do not click to upgrade them yet
  3. If Fantastico does not say you have scripts to upgrade then Fantastico is not the reason WordPress is not upgrading. Skip this section.
  4. Use your file manager or FTP program to locate all the wp-config.php files for each WordPress site that is installed on the server
  5. Copy each wp-config.php file to xwp-config.php. Store the copy in the directory that the original is in.
  6. Copy each .htaccess file in the WordPress site’s topmost directory (where wp-config is usually found) to x.htaccess. Store the copy in the directory that the original is in.
  7. For each WordPress installation, create a directory called backup then copy (do not move, just copy) the wp-content directory to the backup directory
  8. Run the Fantastico updater
  9. Check that all of your WordPress sites load properly. If they do not replace each site’s wp-config.php file and .htaccess file with the backups made before the upgrade.

If the site appears to lack  plugins, themes and images, replace the wp-content directory with the backup made before the upgrade process.

A Plugin Is Preventing Upgrades

This is easy to fix:

  1. Disable all plugins
  2. Try the upgrade again
  3. Re-enable all plugins

Plugins with expired licenses are the ones that usually prevent upgrades and update notices.

The Server Has A Very Low Php Memory Limit

To ways to  try fixing this:

  1. Ask your host to increase your PHP memory limit, or
  2. 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?

Comments

    • says

      Something I didn’t mention in the post is that Fantastico creates lock files on the server that ensure the server protects certain files installed by Fantastico. Only the host or (for a VPS or dedicated server) the server admin can remove those lock files.

Leave a Reply