diff --git a/readme.txt b/readme.txt
index 0574a8030..363447b1a 100644
--- a/readme.txt
+++ b/readme.txt
@@ -129,6 +129,10 @@ Track changes to posts when using the block editor.
 
 == Changelog ==
 
+= NEXT =
+
+- Breaking: Use only `$_SERVER['REMOTE_ADDR']` as the reliable client IP address for event logs. This might cause incorrectly reported event log IP addresses on environments where PHP is behind a proxy server or CDN. Use the `wp_stream_client_ip_address` filter to set the correct client IP address (see `readme.txt` for instructions) or configure the hosting environment to report the correct IP address in `$_SERVER['REMOTE_ADDR']`.
+
 = 3.10.0 - October 9, 2023 =
 
 - Fix: Improve PHP 8.1 compatibility by updating `filter_*()` calls referencing `FILTER_SANITIZE_STRING` (issue [#1422](https://github.com/xwp/stream/pull/1422)).