> For AI agents: the complete documentation index is available at /zh/llms.txt, the full documentation bundle is available at /zh/llms-full.txt.

# html.title

- **类型：** `string | Function`
- **默认值：** `'Rsbuild App'`

配置 HTML 页面的 title 标签。

:::tip
如果当前项目使用的 HTML 模板中已经包含了 `<title>` 标签，那么 `html.title` 将不会生效。
:::

## 字符串用法

当 `html.title` 可以直接设置为一个字符串：

```ts title="rsbuild.config.ts"
export default {
  html: {
    title: 'Example',
  },
};
```

最终在 HTML 中生成的 `title` 标签为：

```html
<title>Example</title>
```

## 函数用法

- **类型：**

```ts
type TitleFunction = (context: {
  value: string;
  entryName: string;
}) => string | void | Promise<string | void>;
```

当 `html.title` 为 Function 类型时，函数接收一个对象作为入参，对象的值包括：

- `value`：Rsbuild 的默认 title 配置。
- `entryName`: 当前入口的名称。

在 MPA（多页面应用）场景下，你可以基于入口名称返回不同的 `title` 字符串，从而为每个页面生成不同的 `title` 标签：

```ts title="rsbuild.config.ts"
export default {
  html: {
    title({ entryName }) {
      const titles = {
        foo: 'Foo Page',
        bar: 'Bar Page',
      };
      return titles[entryName] || 'Other Page';
    },
  },
};
```

## 不注入 title 标签

当 `html.title` 设置为空字符串时，Rsbuild 不会注入 `<title>` 标签：

```ts title="rsbuild.config.ts"
export default {
  html: {
    title: '',
  },
};
```

## 版本历史

| 版本     | 变更内容                     |
| ------ | ------------------------ |
| v2.0.8 | 新增对 `html.title` 异步函数的支持 |