- A contributed module has been installed and there is an update available for it. See Section 11.3, “Downloading and Installing a Module from Drupal.org” and Section 13.4, “Keeping Track of Updates”.
- If your site is live, you should test this process in a development environment before running it on your production site. See Section 11.8, “Making a Development Site”.
- You have created a full-site backup. See Section 12.3, “Concept: Data Backups”.
- If you want to use the user interface, the core Update Manager module must be installed. See Section 4.3, “Installing a Module” for instructions on installing core modules.
Before you start, check for module-specific update instructions. This is typically necessary while updating modules that involve the usage of third-party libraries. Read and understand all module-specific requirements before proceeding with the updates. To find instructions, check the module’s project page Read Documentation link.
To view further instructions, download the tar.gz or .zip file from the project page to your local computer. Unzip the file and look for README.txt, INSTALL.txt, and UPGRADE.txt that come with the module’s installation file. Also, review the release notes on the project page by clicking the version number you’re downloading.
You can use the administrative interface to update a contributed module. If you are updating a custom module rather than a contributed module, if you see a message saying Installing modules and themes requires FTP access to your server, or if the steps below do not work to obtain the new module files, follow the steps in Section 11.6, “Manually Downloading Module or Theme Files”. You can then continue here with step 6 in the instructions for the administrative interface below.
If you are using Composer to manage the files in your site, follow the steps in Section 3.5, “Using Composer to Download and Update Files” to update the files, then continue here with step 6 in the instructions for the administrative interface below.
- Put your site in maintenance mode. See Section 11.2, “Enabling and Disabling Maintenance Mode”.
- In the Manage administrative menu, navigate to Reports > Available updates > Update (admin/reports/updates/update).
Find and check the module in the list. Click Download these updates for the module.
- Click Continue.
- Click Run database updates. If you obtained the new module files manually, start with this step, and reach the database updates page by typing the URL example.com/update.php in your browser.
- Click Continue and apply all updates. The database update scripts will be executed.
- Click Administration pages to return to the administration section of your site.
- Take your site out of maintenance mode. See Section 11.2, “Enabling and Disabling Maintenance Mode”.
- Clear the cache (refer to Section 12.2, “Clearing the Cache”).