Custom Error Pages, Tutorials

<!doctype html>  <html class="no-js" lang="en">  <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="alternate" type="application/rss+xml" title="Latest packages" href="//our.umbraco.com/rss/projects" /> <link rel="alternate" type="application/rss+xml" title="Package updates" href="//our.umbraco.com/rss/projectsupdate" /> <link rel="alternate" type="application/rss+xml" title="Active forum topics" href="//our.umbraco.com/rss/activetopics" /> <link rel="search" type="application/opensearchdescription+xml" title="our.umbraco.com" href="/scripts/OpenSearch.xml">  <meta name="application-name" content="Our Umbraco" /> <meta name="apple-mobile-web-app-title" content="Our Umbraco">  <link rel="apple-touch-icon-precomposed" href="/assets/images/app-icons/icon-60.png"> <link rel="apple-touch-icon-precomposed" sizes="72x72" href="/assets/images/app-icons/icon-72.png"> <link rel="apple-touch-icon-precomposed" sizes="76x76" href="/assets/images/app-icons/icon-76.png"> <link rel="icon" sizes="192x192" href="/assets/images/app-icons/touch-icon-192x192.png"> <meta name="msapplication-TileImage" content="/assets/images/app-icons/tile.png" /> <meta name="msapplication-config" content="/assets/images/app-icons/browserconfig.xml"> <link rel="icon" type="image/png" href="/assets/images/app-icons/favicon.png"> <meta name="robots" content="noindex"> <title> Custom Error Pages, Tutorials - Our Umbraco </title> <meta name="description" /> <link rel="canonical" href="https://docs.umbraco.com/umbraco-cms/tutorials/custom-error-page"/> <script type="text/javascript" src="/scripts/jquery-1.9.1.min.js"></script>  <script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start': new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0], j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src= 'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f); })(window,document,'script','dataLayer','GTM-W9TZ2XW');</script>  <link href="/DependencyHandler.axd?s=L2Fzc2V0cy9jc3Mvc3R5bGUubWluLmNzczs&t=Css&cdv=25020301" type="text/css" rel="stylesheet"/><link href="https://cdnjs.cloudflare.com/ajax/libs/fancybox/3.1.20/jquery.fancybox.min.css" type="text/css" rel="stylesheet"/> </head> <body class="wiki-page">  <noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-W9TZ2XW" height="0" width="0" style="display: none; visibility: hidden"></iframe></noscript>  <div class="quick-menu"> <div class="container"> <div class="row"> <div class="col-md-12"> <a href="/member/login">Sign in</a> <a href="/member/Signup">Register</a> </div> </div> </div> </div> <div class="wrapper"> <header> <div class="navigation"> <div class="container"> <div class="row"> <div class="col-md-3"> <a class="logo" href="/">Our Umbraco</a> </div> <div id="toggle" class="menu-toggle"> <a href="#" class="toggle cross"><span></span></a> </div> <nav class="col-md-9"> <ul> <li> <a href="/forum/">Forum</a> </li> <li> <a href="/packages/">Packages</a> </li> <li class="current"> <a href="/documentation/">Documentation</a> </li> <li> <a href="https://community.umbraco.com/">Community</a> </li> <li> <a href="https://discord.umbraco.com/">Discord</a> </li> <li> <a href="/download/">Download</a> </li> <li> <a href="/member/login?redirectUrl=%2fDocumentation%2fTutorials%2fCustom-Error-Pages%2f">Sign in</a><strong> / </strong><a href="/member/Signup">Register</a> </li> </ul> </nav> </div> </div> </div> </header> <div class="has-sidebar"> <div class="documentation"> <div class="page-content"> <div class="sidebar-area"> <div class="sidebar-content"> <div class="content-wrapper"> <nav> <details class="secondary_nav" open> <summary>Menu</summary> <ul class="level-1"> <li class=""> <a href="/documentation/Getting-Started/"><h3>Getting Started</h3></a> <ul class="level-2 "> <li class=""> <a href="/documentation/Getting-Started/Managing-an-Umbraco-project/"><h4>Managing an Umbraco project</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Getting-Started/Editing-websites-with-Umbraco/"><h4>Editing websites with Umbraco</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Getting-Started/Creating-websites-with-Umbraco/"><h4>Creating websites with Umbraco</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Getting-Started/Developing-websites-with-Umbraco/"><h4>Developing websites with Umbraco</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Getting-Started/Developing-websites-with-Umbraco/Customizing-Umbraco-sites/"><h5>Customizing Umbraco sites</h5></a></li> <li class=""><a href="/documentation/Getting-Started/Developing-websites-with-Umbraco/Extending-the-Umbraco-Backoffice/"><h5>Extending the Umbraco Backoffice</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Getting-Started/Hosting-an-Umbraco-infrastructure/"><h4>Hosting an Umbraco infrastructure</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Getting-Started/Where-can-I-get-help/"><h4>Where can I get help</h4></a> <ul class="level-3 "> </ul> </li> </ul> </li> <li class=""> <a href="/documentation/Fundamentals/"><h3>Fundamentals</h3></a> <ul class="level-2 "> <li class=""> <a href="/documentation/Fundamentals/Setup/"><h4>Setup</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Fundamentals/Setup/Requirements/"><h5>Requirements</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Setup/Install/"><h5>Install</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Setup/Upgrading/"><h5>Upgrading</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Setup/Server-Setup/"><h5>Server Setup</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Fundamentals/Backoffice/"><h4>Backoffice</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Fundamentals/Backoffice/Sections/"><h5>Sections</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Backoffice/Property-Editors/"><h5>Property Editors</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Backoffice/Login/"><h5>Login</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Backoffice/Content-Templates/"><h5>Content Templates</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Backoffice/Infinite-editing/"><h5>Infinite editing</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Backoffice/LogViewer/"><h5>LogViewer</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Backoffice/Variants/"><h5>Variants</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Fundamentals/Data/"><h4>Data</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Fundamentals/Data/Defining-content/"><h5>Defining content</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Creating-Media/"><h5>Creating Media</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Members/"><h5>Members</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Data-Types/"><h5>Data Types</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Scheduled-Publishing/"><h5>Scheduled Publishing</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Adding-Tabs/"><h5>Adding Tabs</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Dictionary-Items/"><h5>Dictionary Items</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Relations/"><h5>Relations</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Users/"><h5>Users</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Fundamentals/Design/"><h4>Design</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Fundamentals/Design/Templates/"><h5>Templates</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Design/Rendering-Content/"><h5>Rendering Content</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Design/Rendering-Media/"><h5>Rendering Media</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Design/Stylesheets-Javascript/"><h5>Stylesheets Javascript</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Design/Partial-View-Macro-Files/"><h5>Partial View Macro Files</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Design/Partial-Views/"><h5>Partial Views</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Fundamentals/Code/"><h4>Code</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Fundamentals/Code/Umbraco-Services/"><h5>Umbraco Services</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Code/Subscribing-To-Events/"><h5>Subscribing To Events</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Code/Creating-Forms/"><h5>Creating Forms</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Code/Debugging/"><h5>Debugging</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Code/Source-Control/"><h5>Source Control</h5></a></li> </ul> </li> </ul> </li> <li class=""> <a href="/documentation/Implementation/"><h3>Implementation</h3></a> <ul class="level-2 "> <li class=""> <a href="/documentation/Implementation/Default-Routing/"><h4>Default Routing</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Implementation/Default-Routing/Inbound-Pipeline/"><h5>Inbound Pipeline</h5></a></li> <li class=""><a href="/documentation/Implementation/Default-Routing/Controller-Selection/"><h5>Controller Selection</h5></a></li> <li class=""><a href="/documentation/Implementation/Default-Routing/Execute-Request/"><h5>Execute Request</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Implementation/Custom-Routing/"><h4>Custom Routing</h4></a> </li> <li class=""> <a href="/documentation/Implementation/Controllers/"><h4>Controllers</h4></a> </li> <li class=""> <a href="/documentation/Implementation/Data-Persistence/"><h4>Data Persistence</h4></a> </li> <li class=""> <a href="/documentation/Implementation/Rest-Api/"><h4>Rest Api</h4></a> </li> <li class=""> <a href="/documentation/Implementation/Composing/"><h4>Composing</h4></a> </li> <li class=""> <a href="/documentation/Implementation/Services/"><h4>Services</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Implementation/Services/Circular-Dependencies/"><h5>Circular Dependencies</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Implementation/Unit-Testing/"><h4>Unit Testing</h4></a> </li> </ul> </li> <li class=""> <a href="/documentation/Extending/"><h3>Extending</h3></a> <ul class="level-2 "> <li class=""> <a href="/documentation/Extending/Dashboards/"><h4>Dashboards</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Extending/Section-Trees/"><h4>Section Trees</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Extending/Section-Trees/Searchable-Trees/"><h5>Searchable Trees</h5></a></li> <li class=""><a href="/documentation/Extending/Section-Trees/Sections/"><h5>Sections</h5></a></li> <li class=""><a href="/documentation/Extending/Section-Trees/Trees/"><h5>Trees</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Extending/Property-Editors/"><h4>Property Editors</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Extending/Property-Editors/Build-a-Block-Editor/"><h5>Build a Block Editor</h5></a></li> <li class=""><a href="/documentation/Extending/Property-Editors/Package-Manifest/"><h5>Package Manifest</h5></a></li> <li class=""><a href="/documentation/Extending/Property-Editors/Property-Actions/"><h5>Property Actions</h5></a></li> <li class=""><a href="/documentation/Extending/Property-Editors/Property-Value-Converters/"><h5>Property Value Converters</h5></a></li> <li class=""><a href="/documentation/Extending/Property-Editors/Tracking/"><h5>Tracking</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Extending/Macro-Parameter-Editors/"><h4>Macro Parameter Editors</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Extending/Health-Check/"><h4>Health Check</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Extending/Health-Check/Guides/"><h5>Guides</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Extending/Language-Files/"><h4>Language Files</h4></a> </li> <li class=""> <a href="/documentation/Extending/Backoffice-Search/"><h4>Backoffice Search</h4></a> </li> <li class=""> <a href="/documentation/Extending/Backoffice-Tours/"><h4>Backoffice Tours</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Extending/Backoffice-UI-API-Documentation/"><h4>Backoffice UI API Documentation</h4></a> </li> <li class=""> <a href="/documentation/Extending/Content-Apps/"><h4>Content Apps</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Extending/Database/"><h4>Database</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Extending/Embedded-Media-Provider/"><h4>Embedded Media Provider</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Extending/FileSystemProviders/"><h4>FileSystemProviders</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Extending/FileSystemProviders/Azure-Blob-Storage/"><h5>Azure Blob Storage</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Extending/Packages/"><h4>Packages</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Extending/Packages/Creating-a-nuget-package/"><h5>Creating a nuget package</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/Creating-a-Package/"><h5>Creating a Package</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/Language-Files-For-Packages/"><h5>Language Files For Packages</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/Maintaining-Packages/"><h5>Maintaining Packages</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/Package-Actions/"><h5>Package Actions</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/Packages-on-Umbraco-Cloud/"><h5>Packages on Umbraco Cloud</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/Types-of-Packages/"><h5>Types of Packages</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/UmbPack/"><h5>UmbPack</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/Uploading-to-Our/"><h5>Uploading to Our</h5></a></li> </ul> </li> </ul> </li> <li class=""> <a href="/documentation/Reference/"><h3>Reference</h3></a> <ul class="level-2 "> <li class=""> <a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/"><h4>Configuration for Umbraco 7 and 8</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/404handlers/"><h5>404handlers</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/applications/"><h5>applications</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/BaseRestExtensions/"><h5>BaseRestExtensions</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/dashboard/"><h5>dashboard</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/EmbeddedMedia/"><h5>EmbeddedMedia</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/ExamineIndex/"><h5>ExamineIndex</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/ExamineSettings/"><h5>ExamineSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/fileSystemProviders/"><h5>fileSystemProviders</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/HealthChecks/"><h5>HealthChecks</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/Serilog/"><h5>Serilog</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/tinyMceConfig/"><h5>tinyMceConfig</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/trees/"><h5>trees</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/umbracoSettings/"><h5>umbracoSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/webconfig/"><h5>webconfig</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Templating/"><h4>Templating</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Templating/Macros/"><h5>Macros</h5></a></li> <li class=""><a href="/documentation/Reference/Templating/Masterpages/"><h5>Masterpages</h5></a></li> <li class=""><a href="/documentation/Reference/Templating/Modelsbuilder/"><h5>Modelsbuilder</h5></a></li> <li class=""><a href="/documentation/Reference/Templating/Mvc/"><h5>Mvc</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Querying/"><h4>Querying</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Querying/DynamicPublishedContent/"><h5>DynamicPublishedContent</h5></a></li> <li class=""><a href="/documentation/Reference/Querying/IPublishedContent/"><h5>IPublishedContent</h5></a></li> <li class=""><a href="/documentation/Reference/Querying/MemberShipHelper/"><h5>MemberShipHelper</h5></a></li> <li class=""><a href="/documentation/Reference/Querying/UmbracoHelper/"><h5>UmbracoHelper</h5></a></li> <li class=""><a href="/documentation/Reference/Querying/UDI-identifiers/"><h5>UDI identifiers</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Routing/"><h4>Routing</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Routing/Authorized/"><h5>Authorized</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/IISRewriteRules/"><h5>IISRewriteRules</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/Request-Pipeline/"><h5>Request Pipeline</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/URL-Tracking/"><h5>URL Tracking</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/Custom-Controllers/"><h5>Custom Controllers</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/Custom-Routes/"><h5>Custom Routes</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/Routing-Properties/"><h5>Routing Properties</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/Surface-Controllers/"><h5>Surface Controllers</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/Umbraco-API-Controllers/"><h5>Umbraco API Controllers</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Searching/"><h4>Searching</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Searching/Examine/"><h5>Examine</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Events/"><h4>Events</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Events/EditorModel-Events/"><h5>EditorModel Events</h5></a></li> <li class=""><a href="/documentation/Reference/Events/MemberService-Events/"><h5>MemberService Events</h5></a></li> <li class=""><a href="/documentation/Reference/Events/ContentService-Events/"><h5>ContentService Events</h5></a></li> <li class=""><a href="/documentation/Reference/Events/ContentTypeService-Events/"><h5>ContentTypeService Events</h5></a></li> <li class=""><a href="/documentation/Reference/Events/DataTypeService-Events/"><h5>DataTypeService Events</h5></a></li> <li class=""><a href="/documentation/Reference/Events/FileService-Events/"><h5>FileService Events</h5></a></li> <li class=""><a href="/documentation/Reference/Events/LocalizationService-Events/"><h5>LocalizationService Events</h5></a></li> <li class=""><a href="/documentation/Reference/Events/MediaService-Events/"><h5>MediaService Events</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Management/"><h4>Management</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Management/Models/"><h5>Models</h5></a></li> <li class=""><a href="/documentation/Reference/Management/Services/"><h5>Services</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Plugins/"><h4>Plugins</h4></a> </li> <li class=""> <a href="/documentation/Reference/Cache/"><h4>Cache</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Cache/Application-Cache/"><h5>Application Cache</h5></a></li> <li class=""><a href="/documentation/Reference/Cache/Examples/"><h5>Examples</h5></a></li> <li class=""><a href="/documentation/Reference/Cache/ICacheRefresher/"><h5>ICacheRefresher</h5></a></li> <li class=""><a href="/documentation/Reference/Cache/Updating-Cache/"><h5>Updating Cache</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Security/"><h4>Security</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Security/Authenticate-with-Active-Directory/"><h5>Authenticate with Active Directory</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Auto-linking/"><h5>Auto linking</h5></a></li> <li class=""><a href="/documentation/Reference/Security/BackOfficeUserManager-and-Notifications/"><h5>BackOfficeUserManager and Notifications</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Custom-password-check/"><h5>Custom password check</h5></a></li> <li class=""><a href="/documentation/Reference/Security/External-login-providers/"><h5>External login providers</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Reset-admin-password/"><h5>Reset admin password</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Security-hardening/"><h5>Security hardening</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Security-settings/"><h5>Security settings</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Sensitive-data-on-members/"><h5>Sensitive data on members</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Serverside-sanitizing/"><h5>Serverside sanitizing</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Setup-Umbraco-for-a-Fips-Server/"><h5>Setup Umbraco for a Fips Server</h5></a></li> <li class=""><a href="/documentation/Reference/Security/SSL-HTTPS/"><h5>SSL HTTPS</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Common-Pitfalls/"><h4>Common Pitfalls</h4></a> </li> <li class=""> <a href="/documentation/Reference/Angular/"><h4>Angular</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Angular/Directives/"><h5>Directives</h5></a></li> <li class=""><a href="/documentation/Reference/Angular/Services/"><h5>Services</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/API-Documentation/"><h4>API Documentation</h4></a> </li> <li class=""> <a href="/documentation/Reference/Debugging/"><h4>Debugging</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Reference/Language-Variation/"><h4>Language Variation</h4></a> </li> <li class=""> <a href="/documentation/Reference/Mapping/"><h4>Mapping</h4></a> </li> <li class=""> <a href="/documentation/Reference/Notifications/"><h4>Notifications</h4></a> </li> <li class=""> <a href="/documentation/Reference/Scheduling/"><h4>Scheduling</h4></a> </li> <li class=""> <a href="/documentation/Reference/Using-Ioc/"><h4>Using Ioc</h4></a> </li> <li class=""> <a href="/documentation/Reference/Configuration/"><h4>Configuration</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Configuration/BasicAuthSettings/"><h5>BasicAuthSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/ConnectionStringsSettings/"><h5>ConnectionStringsSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/ContentDashboard/"><h5>ContentDashboard</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/ContentSettings/"><h5>ContentSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/DataTypes/"><h5>DataTypes</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/DebugSettings/"><h5>DebugSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/ExceptionFilterSettings/"><h5>ExceptionFilterSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/GlobalSettings/"><h5>GlobalSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/HostingSettings/"><h5>HostingSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/ImagingSettings/"><h5>ImagingSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/InstallDefaultDataSettings/"><h5>InstallDefaultDataSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/KeepAliveSettings/"><h5>KeepAliveSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/LoggingSettings/"><h5>LoggingSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/MaximumUploadSizeSettings/"><h5>MaximumUploadSizeSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/ModelsBuilderSettings/"><h5>ModelsBuilderSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/NuCacheSettings/"><h5>NuCacheSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/PackageMigrationSettings/"><h5>PackageMigrationSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/PluginsSettings/"><h5>PluginsSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/RequestHandlerSettings/"><h5>RequestHandlerSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/RichTextEditorSettings/"><h5>RichTextEditorSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/RuntimeMinificationSettings/"><h5>RuntimeMinificationSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/RuntimeSettings/"><h5>RuntimeSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/SecuritySettings/"><h5>SecuritySettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/ToursSettings/"><h5>ToursSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/TypeFinderSettings/"><h5>TypeFinderSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/UnattendedSettings/"><h5>UnattendedSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/WebRoutingSettings/"><h5>WebRoutingSettings</h5></a></li> </ul> </li> </ul> </li> <li class="active open"> <a href="/documentation/Tutorials/"><h3>Tutorials</h3></a> <ul class="level-2 open"> <li class=""> <a href="/documentation/Tutorials/Creating-Basic-Site/"><h4>Creating Basic Site</h4></a> <ul class="level-3 open"> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Getting-Started/"><h5>Getting Started</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Document-Types/"><h5>Document Types</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Creating-Your-First-Template-and-Content-Node/"><h5>Creating Your First Template and Content Node</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/CSS-And-Images/"><h5>CSS And Images</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Displaying-the-Document-Type-Properties/"><h5>Displaying the Document Type Properties</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Creating-Master-Template-Part-1/"><h5>Creating Master Template Part 1</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Creating-Master-Template-Part-2/"><h5>Creating Master Template Part 2</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Setting-The-Navigation-Menu/"><h5>Setting The Navigation Menu</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Articles-Parent-and-Article-Items/"><h5>Articles Parent and Article Items</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Adding-Language-Variants/"><h5>Adding Language Variants</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Conclusions-Where-Next/"><h5>Conclusions Where Next</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Creating-a-Custom-Dashboard/"><h4>Creating a Custom Dashboard</h4></a> <ul class="level-3 open"> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Creating-a-Property-Editor/"><h4>Creating a Property Editor</h4></a> <ul class="level-3 open"> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Multilanguage-Setup/"><h4>Multilanguage Setup</h4></a> <ul class="level-3 open"> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Starter-kit/"><h4>Starter kit</h4></a> <ul class="level-3 open"> <li class=""><a href="/documentation/Tutorials/Starter-kit/Lessons/"><h5>Lessons</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Editors-Manual/"><h4>Editors Manual</h4></a> <ul class="level-3 open"> <li class=""><a href="/documentation/Tutorials/Editors-Manual/Getting-Started-With-Umbraco/"><h5>Getting Started With Umbraco</h5></a></li> <li class=""><a href="/documentation/Tutorials/Editors-Manual/Working-with-Content/"><h5>Working with Content</h5></a></li> <li class=""><a href="/documentation/Tutorials/Editors-Manual/Version-Management/"><h5>Version Management</h5></a></li> <li class=""><a href="/documentation/Tutorials/Editors-Manual/Media-Management/"><h5>Media Management</h5></a></li> <li class=""><a href="/documentation/Tutorials/Editors-Manual/Tips-and-Tricks/"><h5>Tips and Tricks</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Add-Google-Authentication/"><h4>Add Google Authentication</h4></a> <ul class="level-3 open"> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Connecting-Umbraco-Forms-and-Zapier/"><h4>Connecting Umbraco Forms and Zapier</h4></a> <ul class="level-3 open"> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Creating-an-XML-Site-Map/"><h4>Creating an XML Site Map</h4></a> <ul class="level-3 open"> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Creating-and-distributing-a-package/"><h4>Creating and distributing a package</h4></a> <ul class="level-3 open"> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Creating-Custom-Views-for-Blocklist/"><h4>Creating Custom Views for Blocklist</h4></a> <ul class="level-3 open"> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Creating-Tables-for-Umbraco-with-PetaPoco/"><h4>Creating Tables for Umbraco with PetaPoco</h4></a> <ul class="level-3 open"> </ul> </li> <li class="active open"> <a href="/documentation/Tutorials/Custom-Error-Pages/"><h4>Custom Error Pages</h4></a> <ul class="level-3 open"> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Members-Registration-And-Logins/"><h4>Members Registration And Logins</h4></a> <ul class="level-3 open"> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Multisite-Setup/"><h4>Multisite Setup</h4></a> <ul class="level-3 open"> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Porting-Packages-V8/"><h4>Porting Packages V8</h4></a> </li> </ul> </li> <li class=""> <a href="/documentation/Add-ons/"><h3>Add ons</h3></a> <ul class="level-2 "> <li class=""> <a href="/documentation/Add-ons/UmbracoForms/"><h4>UmbracoForms</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Add-ons/UmbracoForms/Installation/"><h5>Installation</h5></a></li> <li class=""><a href="/documentation/Add-ons/UmbracoForms/Editor/"><h5>Editor</h5></a></li> <li class=""><a href="/documentation/Add-ons/UmbracoForms/Developer/"><h5>Developer</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Add-ons/Umbraco-Deploy/"><h4>Umbraco Deploy</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Add-ons/Umbraco-Deploy/Get-Started-with-Deploy/"><h5>Get Started with Deploy</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Deploy/Installing-Deploy/"><h5>Installing Deploy</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Deploy/Deployment-Workflow/"><h5>Deployment Workflow</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Deploy/Deploy-Settings/"><h5>Deploy Settings</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Deploy/Upgrades/"><h5>Upgrades</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Deploy/Troubleshooting/"><h5>Troubleshooting</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Deploy/Extending/"><h5>Extending</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Add-ons/The-Licensing-model/"><h4>The Licensing model</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Add-ons/Umbraco-Plumber/"><h4>Umbraco Plumber</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Approval-Groups/"><h5>Approval Groups</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Dashboards-and-Buttons/"><h5>Dashboards and Buttons</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Email-Templates/"><h5>Email Templates</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Events/"><h5>Events</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Getting-Started/"><h5>Getting Started</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Installing-Plumber/"><h5>Installing Plumber</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Licensing/"><h5>Licensing</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Notifications-and-Reminders/"><h5>Notifications and Reminders</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Upgrading-Plumber/"><h5>Upgrading Plumber</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Workflow-Content-App/"><h5>Workflow Content App</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Workflow-History/"><h5>Workflow History</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Workflow-Settings/"><h5>Workflow Settings</h5></a></li> </ul> </li> </ul> </li> <li class=""> <a href="/documentation/Contribute/"><h3>Contribute</h3></a> <ul class="level-2 "> <li class=""> <a href="/documentation/Contribute/Adding-Metadata/"><h4>Adding Metadata</h4></a> </li> <li class=""> <a href="/documentation/Contribute/Code-samples/"><h4>Code samples</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Contribute/DocsTemplates/"><h4>DocsTemplates</h4></a> </li> <li class=""> <a href="/documentation/Contribute/File-Naming-Conventions/"><h4>File Naming Conventions</h4></a> </li> <li class=""> <a href="/documentation/Contribute/How-to-add-a-new-version/"><h4>How to add a new version</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Contribute/Issues/"><h4>Issues</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Contribute/Markdown-Conventions/"><h4>Markdown Conventions</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Contribute/Pull-Requests/"><h4>Pull Requests</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Contribute/Style-Guide/"><h4>Style Guide</h4></a> <ul class="level-3 "> </ul> </li> </ul> </li> </ul> </details> </nav> </div> </div> </div> <div class="main-area"> <div class="main-content"> <div class="content-wrapper"> <div> <div class="utilities"> <ul id="breadcrumb"> <li><a href="/">Our</a></li> <li><a href="/Documentation/">Documentation</a></li> <li><a href="/Documentation/Tutorials/">Tutorials</a></li> <li><a href="/Documentation/Tutorials/Custom-Error-Pages/">Custom Error Pages</a></li> </ul> </div> </div> <div style="width: 100%;" class="alertbar__red"> <h1 style="color: black; font-size: 50px; text-align: center; line-height: 50px; text-decoration: underline;">We have moved!</h1> <p style="font-size:20px; text-align: center; line-height: 50px;">You are currently looking at documentation for Umbraco 8 and older versions. <br> <span>Go to <a href="https://docs.umbraco.com/umbraco-cms/tutorials/custom-error-page">docs.umbraco.com/umbraco-cms/tutorials/custom-error-page</a> for documentation for Umbraco 9 and newer versions.</span> </p> </div> <div class="search-big"> <div class="textSearch"> <input type="search" class="docs-search-input" required placeholder="Search for documentation"> <label for="search">Search for documentation</label> </div> </div> <ul class="search-all-results docs-search-listing"></ul> <div id="markdown-docs" class="docs-default-listing markdown-syntax"> <style> #markdown-docs .anchorjs-link { color: #ff6e00 !important; font-size: 20px !important; text-decoration: none !important; } #markdown-docs a.offset-anchor { visibility: hidden; position: relative; top: -100px; display: block; } </style> <script type="text/javascript" src="/scripts/anchorjs/anchorjs.custom.js"></script> <script type="text/javascript"> $(document).ready(function () { anchors.options = { placement: 'left', visible: "hover", anchorCreated: function (e) { var id = $(e).attr('id'); //clear it's id since we'll be creating a custom anchor point with an offset $(e).removeAttr("id"); $(e).addClass("anchorjs-heading"); $(e).prepend("<a class='offset-anchor' id='" + id + "'></a>"); } }; anchors.add('.markdown-syntax h1, .markdown-syntax h2, .markdown-syntax h3, .markdown-syntax h4, .markdown-syntax h5, .markdown-syntax h5'); var element = $(window.location.hash); if (element.length === 1) { setTimeout(function () { //hightlight it element.closest(".anchorjs-heading").css("color", "#ff6e00"); element.closest(".anchorjs-heading").find("a").not(".anchorjs-link").css("color", "#ff6e00"); }, 100); } $("#markdown-docs .anchorjs-link").click(function () { if (element.length === 1) { //un hightlight it element.closest(".anchorjs-heading").css("color", "inherit"); element.closest(".anchorjs-heading").find("a").not(".anchorjs-link").css("color", "inherit"); } }); }); </script> <aside> <div class="info-box docs-version-panel"> <dl> <dt>Versions</dt> <dd class="current-version selected-version"> 8.0.0 + </dd> </dl> </div> </aside> <h1 id="implementing-custom-error-pages">Implementing custom error pages</h1> <p>Since Umbraco is built upon Microsoft's .NET Framework and is using ASP.NET, you have several options when it comes to setting up custom error pages on your website.</p> <p>Custom error handling might make your site look more on-brand and minimize the impact of errors on user experience - for example, a custom 404 with some helpful links (or a search function) could bring some value to the site.</p> <h2 id="contents">Contents</h2> <p>This article contains guides on how to create custom error pages for the following types of errors:</p> <ul> <li><a href="#50-errors" rel="nofollow">50* errors (hosting related)</a></li> <li><a href="#404-errors" rel="nofollow">404 errors ("Page note found")</a></li> <li><a href="#errors-with-booting-a-project" rel="nofollow">Errors with booting a project</a></li> </ul> <h2 id="in-code-error-page-handling">In-code error page handling</h2> <p>One way is to watch for error events and serve corresponding pages via C# code. Please refer to the <a href="../../Reference/Config/404handlers/" rel="nofollow">Custom 404 handlers</a> article for an example.</p> <h2 id="50-errors">50* errors</h2> <p>Another approach for implementing a custom error page would be to specify a page that will be displayed whenever the application encounters a particular error. For this, you will need to create <code>.aspx</code> files to use as error pages, and change the <code>customErrors</code> line in <code>web.config</code> file.</p> <p>For a generic error message:</p> <div class="highlight xml"><pre> <<span class="element">customErrors</span> <span class="attribute">mode</span><span class="string">=</span><span class="quot">"</span><span class="string">On</span><span class="quot">"</span> <span class="attribute">redirectMode</span><span class="string">=</span><span class="quot">"</span><span class="string">ResponseRewrite</span><span class="quot">"</span> <span class="attribute">defaultRedirect</span><span class="string">=</span><span class="quot">"</span><span class="string">error.aspx</span><span class="quot">"</span><span class="string">/></span> </pre></div> <p>If you want to handle error code 500:</p> <div class="highlight xml"><pre> <<span class="element">customErrors</span> <span class="attribute">mode</span><span class="string">=</span><span class="quot">"</span><span class="string">On</span><span class="quot">"</span> <span class="attribute">redirectMode</span><span class="string">=</span><span class="quot">"</span><span class="string">ResponseRewrite</span><span class="quot">"</span> <span class="attribute">defaultRedirect</span><span class="string">=</span><span class="quot">"</span><span class="string">error.aspx</span><span class="quot">"</span>> <<span class="element">error</span> <span class="attribute">statusCode</span><span class="string">=</span><span class="quot">"</span><span class="string">500</span><span class="quot">"</span> <span class="attribute">redirect</span><span class="string">=</span><span class="quot">"</span><span class="string">500.aspx</span><span class="quot">"</span> <span class="string">/></span> </<span class="element">customErrors</span>> </pre></div> <p>The above code would work for error 500, which covers compilation errors in Umbraco.</p> <p>Please note the <code>error.aspx</code> and <code>500.aspx</code> pages in the above examples would be placed in the root of the site - relative to <code>web.config</code>.</p> <p>The above approach for handling 404 errors would not work, however - for this, we need to change things up a bit.</p> <h2 id="404-errors">404 errors</h2> <p>In this method we will use a 404 page created via the backoffice.</p> <h3 id="why-is-the-method-different-for-error-404">Why is the method different for error 404?</h3> <p>In the first example, we set up a custom error 500 page in web.config. If you try setting it up in umbracoSettings.config it will not work. Although the 404 page sample we set up in the above section did work. Why is that?</p> <p>The 50* errors are all related to the hosting - they come from IIS. That means they are hit 1 layer above Umbraco itself, and as such you can't manage them from Umbraco. It is possible to customize them through the web.config, though.</p> <h3 id="create-a-404-page-in-the-backoffice">Create a 404 page in the backoffice</h3> <p>First, create a new document type (though you could also use a more generic document type if you already have one) called Page404. Make sure the permissions are set to create it under Content. Properties on this document type are optional - in most cases, the 404 not found page would be static. Make sure to assign (and fill out) the template for your error page, and then create it in Content.`</p> <h3 id="set-a-custom-404-page-in-umbracosettingsconfig">Set a custom 404 page in umbracoSettings.config</h3> <p>Once all of that is done, grab your published error page's ID, GUID or path and head on over to the config folder. In there, find umbracoSettings.config file and open it up. In the <code><errors></code> section, you can specify redirects for specific error codes as well!</p> <p>Let us look at the <code><error404></code> tag. As the config specifies in the example, the value for error pages can be:</p> <ul> <li>A content item's GUID ID (example: 26C1D84F-C900-4D53-B167-E25CC489DAC8)</li> <li>An XPath statement (example: //errorPages[@nodeName='My cool error']</li> <li>A content item's integer ID (example: 1234)</li> </ul> <p>That is where the value you grabbed earlier comes in. Fill it out like so:</p> <div class="highlight xml"><pre> <<span class="element">error404</span>> <<span class="element">errorPage</span> <span class="attribute">culture</span><span class="string">=</span><span class="quot">"</span><span class="string">default</span><span class="quot">"</span>>81dbb860-a2e3-49df-9a1c-2e04a8012c03</<span class="element">errorPage</span>> </<span class="element">error404</span>> </pre></div> <p>The above sample uses a GUID value.</p> <div class="note"><p>With this approach, you can set different 404 pages for different languages (cultures) - such as <code>en-us</code>, <code>it</code> etc.</p> </div> <div class="warning"><p>If you are hosting your site on Umbraco Cloud, the best approach would be using an XPath statement - since content IDs might differ across Cloud environments.</p> </div> <h2 id="errors-with-booting-a-project">Errors with booting a project</h2> <p>Sometimes you might experience issues with booting up your Umbraco project. This could be a brand new project, or it could be an existing project after an upgrade.</p> <p>When there is an error during boot you will presented with a generic error page.</p> <p><img src="images/BootFailedGeneric.png" alt="Boot Failed. Umbraco failed to boot, if you are the owner of the website please see the log file for more details." title="Screen shot of generic BootFailed page" /></p> <p>The file used for rendering this error page can be found here <code>~/umbraco/views/errors/BootFailed.html</code>.</p> <p>In order to customize this error page it is recommend that you create a <strong>new HTML file</strong> in <code>~/config/errors/</code> using the name <code>BootFailed.html</code>.</p> <div class="note"><p>The <code>BootFailed.html</code> page will only be shown if debugging is disabled in <code>web.config</code> i.e. <code><compilation debug="false" /></code>. The full error can always be found in the log file.</p> </div> <h2 id="are-the-error-pages-not-working">Are the error pages not working?</h2> <p>If you set up everything correctly and the error pages are not showing correctly, make sure that you are not using</p> <ul> <li>Custom <a href="../../Reference/routing/request-pipeline/IContentFinder/" rel="nofollow">ContentFinders</a> in your solution,</li> <li>Any packages that allow you to customize redirects, or</li> <li>Rewrite rules in web.config that might interefere with custom error handling.</li> </ul> </div> </div> </div> </div> </div> <script type="text/template" class="search-item-docs"> <li> <a href="{{ url }}"> <div class="type-icon"> <i class="icon-Book-alt"></i> </div> <div class="type-context"> <div class="type-name"> {{ name }} </div> <div class="type-description"> {{ body }} </div> </div> </a> </li> </script> </div> </div> <footer> <div class="container is-narrow-tablet"> <div class="row"> <div class="col-xs-12"> <p><a href="/code-of-conduct">Code Of Conduct</a> - <a href="/privacy-policy">Privacy Policy</a></p> <p> </p> Our.umbraco.com is the community mothership for <a href="https://umbraco.com" target="_blank" rel="noopener noreferrer">Umbraco</a>, the open source asp.net cms. With a friendly forum for all your questions, a comprehensive documentation and a ton of packages from the community. </div> </div> </div> </footer> </div>  <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery-validate/1.13.1/jquery.validate.min.js" type="text/javascript"></script><script src="https://ajax.aspnetcdn.com/ajax/mvc/4.0/jquery.validate.unobtrusive.min.js" type="text/javascript"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/pagedown/1.0/Markdown.Converter.js" type="text/javascript"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/pagedown/1.0/Markdown.Editor.js" type="text/javascript"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/pagedown/1.0/Markdown.Sanitizer.js" type="text/javascript"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/mustache.js/0.8.1/mustache.min.js" type="text/javascript"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/fancybox/3.1.20/jquery.fancybox.min.js" type="text/javascript"></script><script src="/DependencyHandler.axd?s=L2Fzc2V0cy9qcy9qcXVlcnkuYWpheGZpbGV1cGxvYWQuanM7L2Fzc2V0cy9qcy9qcXVlcnkuc2Nyb2xseS5qczsvYXNzZXRzL2pzL2xvZGFzaC5taW4uanM7L2Fzc2V0cy9qcy9jb21tdW5pdHkuanM7L2Fzc2V0cy9qcy9hcHAubWluLmpzOy9hc3NldHMvanMvZWRpdG9yLm1pbi5qczs&t=Javascript&cdv=25020301" type="text/javascript"></script> </body> </html>

CINXE.COM

Custom Error Pages, Tutorials - Our Umbraco