mintlify__docs/zh/customize/custom-404-page.mdx

---
title: "自定义 404 页面"
description: "自定义文档站点 404 错误页面的标题、描述和外观，以匹配你的品牌风格并引导访客。"
keywords: ["404 error page", "custom error pages"]
---

所有 404 页面都会根据请求的 URL 自动推荐相关页面。如果用户进入 404 页面，智能助手会分析路径，并从你的文档中检索语义相关的页面，帮助他们找到所需内容。

你可以自定义 404 错误页面的标题和描述。可以在描述中添加有用的链接或指引。

<div id="configuration">
  ## 配置
</div>

在 `docs.json` 文件的 `errors.404` 部分配置你的 404 页面：

```json
"errors": {
  "404": {
    "redirect": false,
    "title": "页面未找到",
    "description": "这个_页面_**怎么了**？"
  }
}
```


<div id="parameters">
  ## 参数
</div>

<ResponseField name="redirect" type="boolean">
  当页面不存在时，是否自动重定向到首页。
  
  设为 `true` 将重定向到首页。

  设为 `false` 将显示自定义 404 页面。
</ResponseField>

<ResponseField name="title" type="string">
  404 错误页面的自定义标题。将替换默认的“Page not found”标题。
</ResponseField>

<ResponseField name="description" type="string">
  404 错误页面的自定义说明。支持 MDX 格式，包括链接、加粗、斜体文本和自定义组件。
</ResponseField>