diff --git a/doc/configuration.txt b/doc/configuration.txt
index 520db4126..ce96c44e7 100644
--- a/doc/configuration.txt
+++ b/doc/configuration.txt
@@ -6019,6 +6019,11 @@ http-request normalize-uri query-sort-by-name [ { if | unless } <condition> ]
 
   Performs normalization of the request's URI.
 
+  URI normalization in HAProxy 2.4 is currently available as an experimental
+  technical preview. You should be prepared that the behavior of normalizers
+  might change to fix possible issues, possibly breaking proper request
+  processing in your infrastructure.
+
   Each normalizer handles a single type of normalization to allow for a
   fine-grained selection of the level of normalization that is appropriate for
   the supported backend.