13.7. Updating a Theme
Last updated on
14 April 2025
- A contributed theme has been installed and there is an update available for it. See Secció 11.5, «Downloading and Installing a Theme from Drupal.org» and Secció 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 Secció 11.8, «Making a Development Site».
- You have created a full site backup. See Secció 12.3, «Concept: Data Backups».
- If you want to use the user interface, the core Update Manager module must be installed. See Secció 4.3, «Installing a Module» for instructions on installing core modules.
- If you want to use Drush, Drush must be installed. See Secció 3.2, «Concepte: Eines addicionals».
You can use the administrative interface or Drush to update a contributed theme. If you are updating a custom theme rather than a contributed theme, 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 theme files, follow the steps in Secció 11.6, «Manually Downloading Module or Theme Files», and then continue with step 6 in the instructions for administrative interface below.
- Put your site in maintenance mode. See Secció 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 theme in the list. Click Download these updates for the theme.
- Click Continue.
- Click Run database updates. If you obtained the new theme 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 to run the 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 Secció 11.2, «Enabling and Disabling Maintenance Mode».
- Clear the Drupal cache (refer to Secció 12.2, «Clearing the Cache»).
- Find the project name for the theme you wish to update, which is the last segment of the theme’s project page URL. For example, if the project URL is https://www.drupal.org/project/mayo, the project name is "mayo".
Run the following Drush command, giving the project name (for example,
mayo) as a parameter:drush up mayo
- Follow the instructions on the screen.
- Review the site log, see Secció 12.4, «Concept: Log», once the updates are complete to check for errors.
- Secció 13.6, «Updating a Module»
Attributions
Written by Boris Doesborg.
This page is generated from AsciiDoc source from the User Guide. To propose a change, edit the source and attach the file to a new issue in the User Guide project. PDF and e-book formats are available on the User Guide project page.
Source file: security-update-theme.asciidoc
Help improve this page
Page status: No known problems
You can:
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
