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

📘

Note

Prior to Content Cloud version 12, the maintenance file size should be between 512 bytes and 1 MB. Content Cloud version 12 removes this restriction.

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

See also: