Skip to main content
Mintlify 中有些名称可以随时更改,有些则在创建时固定:
  • 可更改:部署的项目名称、docs.json 中的文档站点名称,以及自定义域名。
  • 固定:部署的子域名和组织名称。要更改这两者,只能删除后重新创建。

重命名部署的项目名称

项目名称是显示在控制台顶栏中的展示名称。修改方法:
  1. 进入控制台的常规设置页面。
  2. Deployment name 字段中输入新名称。名称长度为 3 到 100 个字符,只能包含字母、数字、连字符和下划线。
  3. 保存更改。
重命名项目需要具有更新部署的权限。如果该字段不可编辑,请联系组织的 admin。参见角色和权限

更改部署的子域名

子域名用于标识你的部署。它出现在 <subdomain>.mintlify.app URL 和控制台 URL app.mintlify.com/<org>/<subdomain> 中。部署创建后无法更改子域名。 要使用不同的子域名,请先用想要的名称创建一个新部署,然后删除旧部署:
  1. 创建一个连接到同一仓库的新部署。
  2. 如果你使用自定义域名,先从旧部署中移除,再添加到新部署。参见自定义域名
  3. 危险区中删除旧部署。参见删除部署
删除部署是永久性的,会移除所有部署数据,包括分析历史记录和所有关联的预览部署。控制台设置不会转移到新部署,请在创建新部署后重新配置。

重命名组织

组织名称无法更改。要使用不同的组织名称,请创建一个新组织,在其中重新创建你的部署,然后在危险区中删除旧组织。删除组织不可撤销,并且需要 admin 角色

读者看到的内容

读者很少能看到你的子域名和组织名称,因此你可能不需要重命名任何内容:
  • 文档上显示的站点名称来自 docs.json 中的 name 字段,可以随时更改。
  • 读者访问的 URL 可以是自定义域名,例如 docs.example.com,可以随时添加或更改。

相关主题

部署GitLab角色