diff --git a/modules/n1ql/pages/n1ql-language-reference/index-partitioning.adoc b/modules/n1ql/pages/n1ql-language-reference/index-partitioning.adoc
index 9923f8750..222ebef72 100644
--- a/modules/n1ql/pages/n1ql-language-reference/index-partitioning.adoc
+++ b/modules/n1ql/pages/n1ql-language-reference/index-partitioning.adoc
@@ -532,6 +532,8 @@ Non-array fields will be ignored.
 | `50`
 |===
 
+NOTE: Couchbase recommends setting the residentRatio property value over 10 to avoid issues, for example, index build failures.
+
 To provide sizing estimation, you can use a command similar to the following examples.
 
 [.server]