diff --git a/website/docs/en/guide/basic/html-template.mdx b/website/docs/en/guide/basic/html-template.mdx
index d9a29d5a2c..9e2cb1ee08 100644
--- a/website/docs/en/guide/basic/html-template.mdx
+++ b/website/docs/en/guide/basic/html-template.mdx
@@ -58,6 +58,10 @@ export default {
 };
 ```
 
+:::tip
+For single-page applications (SPA), Rsbuild will include an initial title in the HTML page, but you usually need to dynamically update the page title on route switching, for example using some routing libraries or libraries like [React Helmet](https://github.com/nfl/react-helmet).
+:::
+
 ## Set Page Icon
 
 Rsbuild supports setting [favicon](https://developer.mozilla.org/en-US/docs/Glossary/Favicon) icon and [apple-touch-icon](https://webhint.io/docs/user-guide/hints/hint-apple-touch-icons/) icon.
diff --git a/website/docs/zh/guide/basic/html-template.mdx b/website/docs/zh/guide/basic/html-template.mdx
index c9ccdca82d..6e4d5b401c 100644
--- a/website/docs/zh/guide/basic/html-template.mdx
+++ b/website/docs/zh/guide/basic/html-template.mdx
@@ -42,7 +42,7 @@ export default {
 };
 ```
 
-当你的项目中有多个页面时，可以基于入口名称来为不同的页面设置对应的标题。
+当你的项目中有多个页面时，可以基于入口名称，来为不同的页面设置对应的标题。
 
 ```ts
 export default {
@@ -58,6 +58,10 @@ export default {
 };
 ```
 
+:::tip
+对于单页应用（SPA），Rsbuild 会在 HTML 页面中包含一个初始的 title，但你通常需要在路由切换时动态更新页面标题，例如使用一些路由库，或是 [React Helmet](https://github.com/nfl/react-helmet) 这类库。
+:::
+
 ## 设置页面图标
 
 Rsbuild 支持设置 [favicon](https://developer.mozilla.org/en-US/docs/Glossary/Favicon) 图标 和 iOS 系统下的 [apple-touch-icon](https://webhint.io/docs/user-guide/hints/hint-apple-touch-icons/) 图标。