• Go into the pub/errors
  • Create a copy of the local.xml.sample and rename it as local.xml
  • Edit the with custom name. Ex – mytheme


<?xml version="1.0"?>

Create a copy of the 'default' folder and rename it with skin name. Ex – mytheme

Locate the 503.phtml inside the newly created folder and add custom code. Add the styles inside css/styles.css and relevant images under images folder.

Enable maintenance mode

php bin/magento maintenance:enable


Exception #0 (Exception): Unable to proceed: the maintenance mode is enabled.
  • Is this the correct approach to display custom maintenance page. Magento ver. 2.2.0 ?

1 Answer 1


You must have your site in developer mode, switch it to production mode and you will see the 503.phtml page displayed.

php bin/magento deploy:mode:set production

  • add the -s flag to skip compilation and quickly enter production mode
    – kmdsax
    Aug 6, 2020 at 22:54

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.