diff --git a/docs/reference/modules/http.asciidoc b/docs/reference/modules/http.asciidoc
index 8c7da111db3..3f7d1b6109f 100644
--- a/docs/reference/modules/http.asciidoc
+++ b/docs/reference/modules/http.asciidoc
@@ -15,6 +15,8 @@ when connecting for better performance and try to get your favorite
 client not to do
 http://en.wikipedia.org/wiki/Chunked_transfer_encoding[HTTP chunking].
 
+IMPORTANT: HTTP pipelining is not supported and should be disabled in your HTTP client.
+
 [float]
 === Settings