Custom 404
A branded not-found page that helps readers find their way.
Custom 404
When someone hits a URL that doesn't exist, they get a themed page inside your site's chrome — not a bare error. It suggests real pages based on the URL they tried, so a mistyped or stale link still points somewhere useful. (Try any made-up path on this site.)
It works with no configuration. To customize the copy:
{
"errors": {
"404": {
"title": "We couldn't find that page",
"description": "The page may have moved. Head back [home](/) or try the search below."
}
}
}| Field | Required | Notes |
|---|---|---|
title | — | Heading; defaults to "Page not found" |
description | — | Supporting text; supports markdown links |
redirect | — | true sends visitors straight to the home page instead of showing the 404 page |
Suggestions
The "were you looking for?" list is generated live from your site's search index using the words in the requested URL — no setup, and it stays current as your docs change.
Redirect instead
If you'd rather bounce every unknown URL to your home page:
{ "errors": { "404": { "redirect": true } } }