diff --git a/modules/ROOT/pages/tools/cypher-shell.adoc b/modules/ROOT/pages/tools/cypher-shell.adoc
index bb3ccfa0d..47c9baf87 100644
--- a/modules/ROOT/pages/tools/cypher-shell.adoc
+++ b/modules/ROOT/pages/tools/cypher-shell.adoc
@@ -413,6 +413,7 @@ type example.cypher | bin/cypher-shell.bat -u neo4j -p <password> --format plain
 
 Cypher Shell supports querying based on parameters.
 Use `:param <Cypher Map>` to set parameters or the older arrow syntax `:param name => <Cypher Expression>`.
+When using the arrow syntax, expressions are restricted to a single line.
 List current parameters with `:param`.
 Clear parameters with `:param clear`.