diff --git a/docs/reference/search/suggesters/phrase-suggest.asciidoc b/docs/reference/search/suggesters/phrase-suggest.asciidoc
index 80ee28aeddb..fb75fb76ad0 100644
--- a/docs/reference/search/suggesters/phrase-suggest.asciidoc
+++ b/docs/reference/search/suggesters/phrase-suggest.asciidoc
@@ -124,7 +124,10 @@ can contain misspellings (See parameter descriptions below).
     accepts a float value in the range `[0..1)` as a fraction of the actual
     query terms a number `>=1` as an absolute number of query terms. The
     default is set to `1.0` which corresponds to that only corrections with
-    at most 1 misspelled term are returned.
+    at most 1 misspelled term are returned.  Note that setting this too high
+    can negativly impact performance. Low values like `1` or `2` are recommended
+    otherwise the time spend in suggest calls might exceed the time spend in 
+    query execution.
 
 `separator`:: 
     the separator that is used to separate terms in the