Detailed guide. An unofficial adaptation of User Guide 11.5. Source updated April 14, 2025; reviewed November 6, 2026. No running-Drupal procedure test has been performed.
Official source ↗ · Previous: 11.4 Finding and Evaluating Themes · Chapter 11 overview · Next: 11.6 Placing Custom Module and Theme Files
Goal and preparation
After evaluating a theme , download it with Composer, install it and select it as default when intended. Custom themes start with 11.6 .
Adapted procedure
Check the project’s release compatibility and command. The source uses Honey only as an installation example, not a current recommendation:
# Historical example; replace with a verified compatible package/version.
composer require 'drupal/honey:^1.0'
At /admin/appearance, select Install and set as default for the theme. Its Drush alternative is:
drush theme:enable honey
drush config:set system.theme default honey
Our verification examples
Download, installation and default selection are distinct. Check ordinary pages separately from the administration theme, and inspect regions, menus, content, images, forms, languages and screen widths. Before following the optional old-theme removal exercise, check dependencies and recovery plans. A required base theme must not be removed merely because it is not the visible default.
Sources, credits and changes
Source: Drupal User Guide 11.5 ↗ . Contributors and source links listed in its Attributions: Joe Shindelar ↗ · Drupalize.Me · Boris Doesborgh ↗ . 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: 11.4 Finding and Evaluating Themes · Chapter 11 overview · Next: 11.6 Placing Custom Module and Theme Files
Chapter 10 details · Chapter 12 · All chapters · Search official information