Detailed guide. An unofficial adaptation of User Guide 11.2. Source updated April 14, 2025; reviewed November 6, 2026. No running-Drupal procedure test has been performed.
Official source ↗ · Previous: 11.1 Finding and Evaluating Modules · Chapter 11 overview · Next: 11.3 Downloading and Installing a Contributed Module
Purpose and prerequisites
Maintenance mode presents a notice to ordinary visitors while suitably permitted accounts can continue working. It is not a backup or a complete network isolation mechanism.
Administration interface
At /admin/config/development/maintenance, enable the mode, enter a notice and save. The message can use @site. Verify using a separate logged-out browser. To disable it, clear the checkbox, save and check anonymous access again. Investigate caches if output remains stale.
Drush alternative
With Drush available, these documentation examples enable and later disable the mode in the intended Drupal project:
drush config:set system.maintenance message "Maintenance in progress" -y
drush state:set system.maintenance_mode 1 --input-format=integer
drush cache:rebuild
# After completing maintenance:
drush state:set system.maintenance_mode 0 --input-format=integer
drush cache:rebuild
Our verification examples
Confirm the target environment and working administrative access first. The mode is state; the notice is configuration. After disabling, verify login and normal anonymous output. No Drupal setting was changed while preparing this page.
Sources, credits and changes
Source: Drupal User Guide 11.2 ↗ . Contributors and source links listed in its Attributions: Boris Doesborg ↗ · Jojy Alphonso ↗ · Red Crackle · Jennifer Hodgdon ↗ . 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.1 Finding and Evaluating Modules · Chapter 11 overview · Next: 11.3 Downloading and Installing a Contributed Module
Chapter 10 details · Chapter 12 · All chapters · Search official information