diff --git a/docs/build/tools/clients/fcl-js/configure-fcl.md b/docs/build/tools/clients/fcl-js/configure-fcl.md
index 033c057853..271121277a 100644
--- a/docs/build/tools/clients/fcl-js/configure-fcl.md
+++ b/docs/build/tools/clients/fcl-js/configure-fcl.md
@@ -20,6 +20,8 @@ fcl
   .put('baz', 'buz'); // configures "baz" to be "buz"
 ```
 
+> **Note**: For advanced use cases requiring scoped configuration, isolated client instances, or multi-tenancy support, see the [`createFlowClient` reference documentation](./packages-docs/fcl/createFlowClient.md).
+
 ## Getting Configuration Values
 
 The `config` instance has an asynchronous `get` method. You can also pass it a fallback value incase the configuration state does not include what you are wanting.
diff --git a/docs/build/tools/clients/fcl-js/index.md b/docs/build/tools/clients/fcl-js/index.md
index 80374275d2..f2567b4779 100644
--- a/docs/build/tools/clients/fcl-js/index.md
+++ b/docs/build/tools/clients/fcl-js/index.md
@@ -80,6 +80,8 @@ fcl.config({
 fcl.authenticate();
 ```
 
+> **Note**: For advanced configuration patterns including scoped clients and multi-tenancy, see the [`createFlowClient` reference documentation](./packages-docs/fcl/createFlowClient.md).
+
 ![FCL Default Discovery UI](images/discovery.png)
 
 > **Note**: A [Dapper Wallet](https://meetdapper.com/developers) developer account is required.