Upgrading CiviCRM for WordPress¶
Use this document to upgrade CiviCRM installations on WordPress to the latest CiviCRM release.
Make sure you have done the steps listed in before upgrading first.
Download the latest code¶
- Go to the CiviCRM website
Select the latest currently available CiviCRM tarball for WordPress.
Save this file in
If using localization, also download the latest version of the localization files. See the CiviCRM Localisation page about how to install files for running CiviCRM in languages other than American English.
Make sure you have logged in to WordPress as an administrator. Do not log out until the entire process is complete.
The before upgrading steps describe steps for backing everything up in case something goes wrong during the upgrade. In addition to this important safeguard, we also need to actually use the
civicrm.settings.php settings file, as it is, during the upgrade.
For CiviCRM 4.7+
For CiviCRM 4.6 and older
The installer in 4.7 and above does not assume that the content-dir is wp-content. It probably is, but can be renamed/moved as detailed here
- Copy this file to a location outside your WordPress project. You may need to restore it after upgrading.
- Also, if you are using the
<wordpress_root>/wp-content/plugins/civicrm/civicrm/settings_location.phpfile in your implementation, make a copy of this as well as you will need to restore it after upgrading.
CiviCRM files and database¶
- Backup your existing
/wp-content/plugins/civicrm directory by creating an archive or FTPing it to your local computer.
!!! note: It's important at the very least to backup your extensions directory prior to the upgrade. This will be removed in the next few steps. Your extensions folder can be found at Administer menu » System Settings » Directories. Make a note of this location for later.
- Backup your existing database using your Control Panel or other method so that you can recreate the database if required.
Now upgrade the filesystem¶
Remove old CiviCRM files¶
CiviCRM will not run properly if files from previous version are present after the upgrade.
- Make sure you have a good backup of your complete previous version installation
Install new CiviCRM files¶
Unpack the files.
$ cd <wordpress_root>/<content-dir>/plugins $ unzip <civicrm_download_file>.zip
Restoring the CiviCRM settings file.
For 4.6 and earlier you should restore the original
civicrm.settings.php file from your backup into the
<wordpress_root>/wp-content/plugins/civicrm/ directory. For later versions, your
civicrm.settings.php should be located in the uploads directory it is not necessary to restore this file, but you should check that it exists and has the correct settings.
- If you are using the
<wordpress_root>/<content-dir>/plugins/civicrm/civicrm/settings_location.phpfile in your implementation, restore this file from your back-up.
Install localization files (optional)¶
If your site requires the localization files, download the
civicrm-x.x.x-l10n.tar.gz from civicrm.org/download
These files must be untarred under
<wordpress_root>/wp-content/plugins/civicrm/. Please note the
tar.gz file only contains
$ cd <wordpress_root>/<content-dir>/plugins/civicrm $ tar -xf ../civicrm-x.x.x-l10n.tar.gz
If you don't have SSH access and your IP panel does not recognize tar files, you will need to convert it to a zip file.
civicrm-x.x.x-l10n.tar. You should now have a
civicrmdirectory with 2 subdirectories
- Create an empty
- Move the
civicrm2directory (with the 2 subdirectories) into your new
- Zip the
civicrmdirectory and name it
- Now, you can upload
civicrm-x.x.x-l10n.zipand continue with the following steps.
Clear cached files¶
Delete all files in your
For CiviCRM 4.7 and later
For CiviCRM 4.6 and older
Copy back your extensions¶
- Restore the extensions that were previously backed up into the folder where you originally backed up your extensions at the start of the upgrade process.
Upgrade the database¶
Point your web browser to the following URL
You should see the Upgrade screen.
- If you are ready to upgrade, click the Upgrade Now button.
You should see the message Upgrade successful when the upgrade completes.
Now click the Return to CiviCRM home page link. This will rebuild CiviCRM menus automatically and return you to the CiviCRM home dashboard.
See these steps to take after upgrading.