diff --git a/docs/api-reference/next.config.js/basepath.md b/docs/api-reference/next.config.js/basepath.md
index 2c2cec7baaa7e..143763f0f16fe 100644
--- a/docs/api-reference/next.config.js/basepath.md
+++ b/docs/api-reference/next.config.js/basepath.md
@@ -16,6 +16,8 @@ module.exports = {
 }
 ```
 
+Note: this value must be set at build time and can not be changed without re-building as the value is inlined in the client-side bundles.
+
 ## Links
 
 When linking to other pages using `next/link` and `next/router` the `basePath` will be automatically applied.