HotChilli.Umbraco.PageNotFound
18.0.0-beta001
See the version list below for details.
dotnet add package HotChilli.Umbraco.PageNotFound --version 18.0.0-beta001
NuGet\Install-Package HotChilli.Umbraco.PageNotFound -Version 18.0.0-beta001
<PackageReference Include="HotChilli.Umbraco.PageNotFound" Version="18.0.0-beta001" />
<PackageVersion Include="HotChilli.Umbraco.PageNotFound" Version="18.0.0-beta001" />
<PackageReference Include="HotChilli.Umbraco.PageNotFound" />
paket add HotChilli.Umbraco.PageNotFound --version 18.0.0-beta001
#r "nuget: HotChilli.Umbraco.PageNotFound, 18.0.0-beta001"
#:package HotChilli.Umbraco.PageNotFound@18.0.0-beta001
#addin nuget:?package=HotChilli.Umbraco.PageNotFound&version=18.0.0-beta001&prerelease
#tool nuget:?package=HotChilli.Umbraco.PageNotFound&version=18.0.0-beta001&prerelease
Page Not Found Manager

Supported Umbraco Versions
- Version 2.x: Supports Umbraco 9–13
- Version 3.x (beta): Supports Umbraco 14 (see note below)
- Version 17.x: Supports Umbraco 17 (see
dev/umbv17) - Version 18.x: Supports Umbraco 18
Note: There is also a
dev/umbv15branch that targets Umbraco 15. This version was never officially released but should work if needed.
Installation
Install the package from NuGet or the Umbraco Marketplace:
# For Umbraco 9–13
PM> Install-Package HotChilli.Umbraco.PageNotFound -Version 2.*
# For Umbraco 14 (beta)
PM> Install-Package HotChilli.Umbraco.PageNotFound -Version 3.*-beta
# For Umbraco 17
PM> Install-Package HotChilli.Umbraco.PageNotFound -Version 17.*
# For Umbraco 18
PM> Install-Package HotChilli.Umbraco.PageNotFound -Version 18.*
Usage
Once installed, the package registers automatically via an Umbraco Composer. For advanced scenarios, use the UsePageNotFoundManager extension method on IUmbracoBuilder to control when it loads.
Once running, a "Manage 404 Page" action appears on content nodes in the backoffice. This opens a dialog to assign a 404 page for that node and its children, allowing different 404 pages to be configured for different sections of the website.
Relation Tracking
When a 404 page is assigned, the package creates a native Umbraco relation (pageNotFoundManagerRelated) between the content node and its configured 404 page. This means the 404 page will appear as a tracked reference in the backoffice, preventing accidental deletion without warning.
Health Check
A health check is included under the "Page Not Found Manager" group in the Umbraco health check dashboard. It verifies that all configured 404 page references point to content nodes that still exist. If any orphaned references are found (e.g. the 404 page was deleted), the health check reports them and provides an action to remove them automatically.
Development Branches
dev/v2: Umbraco 9–13 (stable)dev/v3: Umbraco 14 (beta)dev/umbv15: Umbraco 15 (unreleased, but should work)dev/umbv17: Umbraco 17dev/umbv18: Umbraco 18 (active development)
Special Thanks
This package is a port of PageNotFoundManager by Tim Geyssens, created with his permission. The code base used as a reference was taken prior to the licensing model change.
Credits
The logo uses 404 from the Noun Project by Ilham Fitrotul Hayat, licensed under CC BY 3.0 US.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Umbraco.Cms.Api.Common (>= 18.0.0 && < 18.99999.9999)
- Umbraco.Cms.Api.Management (>= 18.0.0 && < 18.99999.9999)
- Umbraco.Cms.Web.Website (>= 18.0.0 && < 18.99999.9999)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on HotChilli.Umbraco.PageNotFound:
| Package | Downloads |
|---|---|
|
Webwonders.Umbraco.Startup
Startup for Umbraco |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 18.0.0-beta003 | 103 | 11/2/2026 |
| 18.0.0-beta001 | 248 | 10/13/2026 |
| 17.0.2 | 4,534 | 4/14/2026 |
| 17.0.1 | 848 | 2/1/2026 |
| 17.0.0 | 716 | 11/27/2025 |
| 16.1.0 | 259 | 11/27/2025 |
| 16.1.0-beta002 | 239 | 11/26/2025 |
| 16.1.0-beta001 | 475 | 11/17/2025 |
| 16.0.1 | 627 | 11/17/2025 |
| 16.0.0 | 643 | 8/11/2025 |
| 3.0.0-beta001 | 226 | 7/31/2024 |
| 2.2.3 | 995 | 11/26/2025 |
| 2.2.2 | 14,048 | 4/13/2025 |
| 2.2.1 | 25,622 | 7/6/2024 |
| 2.2.0 | 13,178 | 12/17/2023 |
| 2.1.0 | 15,991 | 9/23/2022 |
| 2.0.0 | 7,032 | 6/21/2022 |
| 1.1.0 | 1,212 | 5/24/2022 |
| 1.0.0 | 6,363 | 2/25/2022 |
| 1.0.0-beta-006 | 805 | 9/15/2021 |