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."
    }
  }
}
FieldRequiredNotes
titleHeading; defaults to "Page not found"
descriptionSupporting text; supports markdown links
redirecttrue 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 } } }