Create a custom maintenance page

When running Optimizely Digital Experience Platform (DXP), you can create a customized maintenance page to be displayed if you have to take down the site, for example deployments. Create an HTML page called maintenancepage.htm in the Application Project folder, and add it to the root directory of your application (should be on the same level as appsettings.json) to be used for deployments.

📘

Note

maintenancepage.htm must not be in the wwwroot folder and must have the Copy Always file property in the Visual Studio project.

This maintenance page cannot use any other files in the environment. Resources such as CSS, Javascript, and images must be hosted elsewhere or embedded in the HTML file to be visible during maintenance.

📘

Note

Prior to Optimizely Content Management System (CMS) version 12, the maintenance file size should be between 512 bytes and 1 MB. CMS version 12 removes this restriction.

A generic maintenance page is used if you do not add this file.

See also: Environment configurations