umbraco-custom-maintenance-page
Installation
SKILL.md
Custom Maintenance Page
Targets Umbraco 17 and later. The UpgradingViewPath guidance applies to Umbraco 17.3 and
later, where unattended migrations run in the background. Earlier Umbraco 17 versions and other
upgrade modes must follow the version specific official documentation. This is not an application
error page. Use umbraco-custom-error-pages for 404, 500, and Boot Failed handling.
Choose the right Umbraco approach
| Situation | Configuration or file | Guidance |
|---|---|---|
| Umbraco 17.3+ unattended upgrades | Umbraco:CMS:Global:UpgradingViewPath and a custom Razor view |
Preferred for the current background upgrade flow. Point the setting at a view such as ~/Views/MyUpgrading.cshtml. |
| The documented generic maintenance page convention | UmbracoWebsite/maintenance.cshtml at the project root |
Follow the official custom maintenance page tutorial when this convention matches the project's upgrade flow and version. |
Fetch the official documentation first. Do not assume the two paths are interchangeable without checking the project's Umbraco version and upgrade mode.