HotChilli.Umbraco.PageNotFound 18.0.0-beta003

This is a prerelease version of HotChilli.Umbraco.PageNotFound.
dotnet add package HotChilli.Umbraco.PageNotFound --version 18.0.0-beta003
                    
NuGet\Install-Package HotChilli.Umbraco.PageNotFound -Version 18.0.0-beta003
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="HotChilli.Umbraco.PageNotFound" Version="18.0.0-beta003" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="HotChilli.Umbraco.PageNotFound" Version="18.0.0-beta003" />
                    
Directory.Packages.props
<PackageReference Include="HotChilli.Umbraco.PageNotFound" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add HotChilli.Umbraco.PageNotFound --version 18.0.0-beta003
                    
#r "nuget: HotChilli.Umbraco.PageNotFound, 18.0.0-beta003"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package HotChilli.Umbraco.PageNotFound@18.0.0-beta003
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=HotChilli.Umbraco.PageNotFound&version=18.0.0-beta003&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=HotChilli.Umbraco.PageNotFound&version=18.0.0-beta003&prerelease
                    
Install as a Cake Tool

Page Not Found Manager

Logo

NuGet Umbraco Marketplace

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/umbv15 branch 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 17
  • dev/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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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
Loading failed