HomeGuidesAPI Reference
Submit Documentation FeedbackJoin Developer CommunityOptimizely GitHubOptimizely NuGetLog In

Custom Maintenance Page

This topic describes the options and limitations for maintenance pages in Optimizely Digital Experience Platform (DXP).

How it works

When running Optimizely 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 in the root directory of your application (should be on the same level as appsettings.json), to be used for deployments.



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, images must either be hosted somewhere else or embedded in the HTML file to be visible during maintenance.



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.

If you do not add this file, a generic maintenance page is used.

See also: