Can't get custom maintenance page to display

Questions
1

I’ve followed the instructions here custom maint page to display a custom maintenance page during upgrade (in this case I’m going from 17.5.3 to 17.6.0 which does display the maint page). However I cannot get the custom page to display, it always shows the default page. Anyone got this to work?

2

I found the docs explanation of where to put the file a bit confusing, so you may have placed it in the wrong spot?

  1. Go to your repo and find the project that has Umbraco
  2. In that project there should be an umbraco folder
  3. Inside that folder create an UmbracoWebsite folder
  4. Inside that folder create a Maintenance.cshtml file

The specific location has to be exact, and I think depending on your OS the casing may also have to?

3

Still not working for me

4

Then you will probably need to share a bit more about your setup.

Also be aware that there is both a maintenance page and an upgrading page, they could be overwritten in the same way:

5

Ok with your helpful pointers it’s sorted, although the documentation is completely inadequate to the actual task. Here’s what I had to do:

  1. Create the UmbracoWebsite folder in the project root/umbraco folder (the one that contains the Data, Licences, Logs etc folders)
  2. copy TWO cshtml files to this folder , one called maintenance.cshtml and one called upgrading.cshtml to handle both scenarios
  3. copy any css, images etc that are referenced by your cshtml files to the project root/wwwroot folder

Now the custom maint page is displayed.

6

It may be that the page you were seeing was the upgrade page not the maintenance page, looks like the upgrade page was recently added in 17.3 so might be missing that update in the docs.

Would be a good idea to raise an issue on the docs repo about this to help others trying to do the same :slightly_smiling_face: