Detailed guide. An unofficial adaptation of User Guide 13.7. Source updated April 14, 2025; reviewed November 6, 2026. No running-Drupal procedure test has been performed.
Official source ↗ · Previous: 13.6 Updating and Verifying a Contributed Module · Chapter 13 overview
Goal and preparation
Update theme code and apply required database/cache steps, then inspect output. Review release notes, base-theme/build dependencies and custom templates or CSS. Prepare backups and a test environment.
Composer example
Honey is the source’s example, not a recommendation. Replace it with a verified compatible package, following official extension guidance ↗ :
composer update drupal/honey --with-all-dependencies
drush updatedb
drush cache:rebuild
We omit the source’s trailing plus sign. Plan maintenance, inspect dependency changes, deploy verified code and check after returning to normal operation. Distinguish custom-theme delivery from contributed package updates; see 11.6 .
Our verification examples
Check layout, menus, blocks, content, media, forms, keyboard use, languages and screen widths. Inspect logs and stale delivery caches, distinguishing public and administration themes. Do not uninstall merely to update, and preserve custom work through reviewed differences. No theme update or switch occurred here.
Sources, credits and changes
Source: Drupal User Guide 13.7 ↗ . Contributors and source links listed in its Attributions: Boris Doesborg ↗ · Joe Shindelar ↗ · Drupalize.Me . Refer to the source for writing, editing and adaptation roles, and to the guide-wide credits ↗ .
Copyright remains with the individual contributors; the official copyright page ↗ states © 2015–2025. Changes include reorganized explanations and procedures, our preparation and verification examples, troubleshooting notes, source-interpretation qualifications and release references. Original screenshots and videos are not reproduced. This adapted text is shared under CC BY-SA 2.0 . It is not an official edition or endorsement. This notice does not license unrelated articles or the site design.
Chapter navigation
Previous: 13.6 Updating and Verifying a Contributed Module · Chapter 13 overview
Chapter 12 details · Chapter 14 · All chapters · Search official information