diff --git a/src/main/asciidoc/reference/programming-model/repositories.adoc b/src/main/asciidoc/reference/programming-model/repositories.adoc
index a96c379a2..d678c69ad 100644
--- a/src/main/asciidoc/reference/programming-model/repositories.adoc
+++ b/src/main/asciidoc/reference/programming-model/repositories.adoc
@@ -62,6 +62,8 @@ All other parameters types are provided directly (i.e. Strings, Longs, etc).
 [NOTE]
 ====
 In the current version, custom queries do not support paging, sorting or a custom depth.
+`@Query` does not support mapping a path to domain entities, as such, a path should not be returned from a Cypher query.
+Instead, return nodes and relationships to have them mapped to domain entities.
 ====
 
 === Query results