Show Custom Maintenance page for PowerApps portal/ Dynamics 365 Portal

If you have designed a portal for enterprise, chances are you need to make periodic deployments. Sometimes these deployments regular functional changes. Other times it may be installing a new update in your environment.

Whatever the type of deployment is, you don’t want your portal users to encounter awkward issues or error when they try to access the portal while the deployment is going on. Ideally you would update your portal users beforehand for a scheduled downtime.

And during this downtime, won’t it be nice to show a custom page to your portal users that deployment is going on and soon it will be up at a specified time? But how can you accomplish the same? Well, no worries here. Microsoft have got your back. There is indeed a way to put a portal in maintenance mode. So let’s see how we can do this.

Custom Maintenance page for PowerApps portal/ Dynamics 365 portals
  • From the pop out menu, click on Settings
Custom Maintenance page for PowerApps portal/ Dynamics 365 portals
  • Click on Portal Actions on the left hand navigation and then click on “Enable maintenance mode”.
Custom Maintenance page for PowerApps portal/ Dynamics 365 portals
  • In the pop-out dialog, you have the option to show either default maintenance page or custom maintenance page.
Custom Maintenance page for PowerApps portal/ Dynamics 365 portals
  • I choose “Custom Page” option. I need to provide a custom page URL. Few things to consider when you use a custom page URL. The first thing is the page should be publicly accessible. And it should it should be https enabled.
Custom Maintenance page for PowerApps portal/ Dynamics 365 portals

That’s it. The portal is now ready to show maintenance mode. However not so fast. The devil is in the details. The portal uses an IFrame to show the maintenance page. So if the page has a response header – x-frame-options: SAMEORIGIN, the page won’t be loaded. So make sure the maintenance mode you set does not have this response header.

You will like the below posts

So that’s good stuff. You have enabled maintenance mode for your portal. But what if you need to disable the maintenance mode or change the maintenance page? It’s actually quite easy.

Once maintenance mode has been enabled, the option now changes to “Configure or disable maintenance mode”.

Custom Maintenance page for PowerApps portal/ Dynamics 365 portals

Once you click on the link, you now have the option to disable the maintenance mode or switch the maintenance page.

Custom Maintenance page for PowerApps portal/ Dynamics 365 portals

So that’s all about maintenance mode for portals. If you are not sure of how to configure PowerApps portals, this will get you started.

Latest Posts:

Hope this helps!

Debajit Dutta
(Business Solutions MVP)