Edit on GitHub
Jump to docs navigation

Other / Maintenance (offline) mode

Note: You are currently reading the documentation for Bolt 5.0. Looking for the documentation for Bolt 5.2 instead?

Bolt comes with a built-in 'Maintenance Mode'. If this mode is active, regular visitors to the site will see the website's configured maintenance page, or a default.

Note: This page returns a HTTP 503 status code. This means "Service Unavailable" and makes the maintenance page search engine friendly.

Any users that are logged in, will be able to use the site as normal, while other visitors will see the maintenance screen. You can enable the Maintenance mode with these settings in the config.yml file:

maintenance_mode: true
maintenance: [ blocks/503-maintenance-mode, 'helpers/page_503.html.twig' ]

The first value turns the maintenance mode on or off. The second option sets the template to use. This an be an (array of) template names or identifiers for records, which will be tried until a match is found. If you wish to change this file, you should set it to another filename, and place that file in your own theme- folder. Otherwise it might be overwritten during an update of Bolt.

Note: If you're testing this feature, be aware that you will not see the maintenance screen if you are logged in. Use another browser to test it.



Edit this page on GitHub
Couldn't find what you were looking for? We are happy to help you in the forum, on Slack or on Github.