The 2026 Drupal Business Survey is open. Your response will help shape the future of the Drupal business ecosystem.13.6. Updating a Module
- A contributed module has been installed and there is an update available for it. See 「Downloading and Installing a Module from Drupal.org」 and 「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 「Making a Development Site」.
- You have created a full-site backup. See 「Concept: Data Backups」.
- If you want to use the user interface, the core Update Manager module must be installed. See 「Installing a Module」 for instructions on installing core modules.
- If you want to use Drush, Drush must be installed. See 「概念: その他のツール」.
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 or Drush 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 「Manually Downloading Module or Theme Files」. You can then continue here with step 6 in the instructions for the administrative interface below.
- Put your site in maintenance mode. See 「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 「Enabling and Disabling Maintenance Mode」.
- Clear the cache (refer to 「Clearing the Cache」).
- Find the project name for the module you wish to update. It is the last segment of the module’s project page URL. For example, if the project URL is https://www.drupal.org/project/admin_toolbar, the project name is "admin_toolbar".
Run the following Drush command, giving the project name (for example,
admin_toolbar) as a parameter (if you have more than one module to update, add the additional module project names to the end of the command, separated by spaces):drush up admin_toolbar
- Follow the instructions on the screen.
- Review the site log (refer to 「Concept: Log」) once the updates are complete to check for errors.
- 「Updating a Theme」
Drupal.org community documentation page "Updating modules"
Attributions
Adapted by Boris Doesborgh, and Sarah German at Advomatic, from "Updating modules", copyright 2000-2017 by the individual contributors to the Drupal Community Documentation.
Source file: security-update-module.asciidoc
Help improve this page
You can:
- Log in, click Edit, and edit this page
- Log in, click Discuss, update the Page status value, and suggest an improvement
- Log in and create a Documentation issue with your suggestion
