diff --git a/src/main/asciidoc/jpa.adoc b/src/main/asciidoc/jpa.adoc
index 1384ba825..d30fbfc90 100644
--- a/src/main/asciidoc/jpa.adoc
+++ b/src/main/asciidoc/jpa.adoc
@@ -680,6 +680,9 @@ public interface GroupRepository extends CrudRepository<GroupInfo, String> {
 ====
 
 
+:repository-projections-dto-limitations-file: ../../../../spring-data-jpa/src/main/asciidoc/repository-projections-dto-limitations.adoc
+
+
 include::{spring-data-commons-docs}/repository-projections.adoc[leveloffset=+2]
 
 [[jpa.stored-procedures]]
diff --git a/src/main/asciidoc/repository-projections-dto-limitations.adoc b/src/main/asciidoc/repository-projections-dto-limitations.adoc
new file mode 100644
index 000000000..44ab3a6bb
--- /dev/null
+++ b/src/main/asciidoc/repository-projections-dto-limitations.adoc
@@ -0,0 +1 @@
+NOTE: Class based projections do not work with native queries. As a workaround you may use named queries with `ResultSetMapping` or the Hibernate specific https://docs.jboss.org/hibernate/orm/6.0/javadocs/org/hibernate/transform/ResultTransformer.html[`ResultTransformer`]