diff --git a/Documentation/Routers/SchemaRouter.md b/Documentation/Routers/SchemaRouter.md
index 8a4c69938..cce393525 100644
--- a/Documentation/Routers/SchemaRouter.md
+++ b/Documentation/Routers/SchemaRouter.md
@@ -200,6 +200,11 @@ will not be consistent anymore.
 
 ### `refresh_databases`
 
+**Note:** This parameter does nothing in 2.4 and newer versions. The
+  database map is only created when the session starts. Follow
+  [MXS-3836](https://jira.mariadb.org/browse/MXS-3836) for more
+  information.
+
 Enable database map refreshing mid-session. These are triggered by a failure to
 change the database i.e. `USE ...` queries.