diff --git a/NEWS b/NEWS
index 887218a2e..72235d84a 100644
--- a/NEWS
+++ b/NEWS
@@ -1,3 +1,35 @@
+=================
+buildstream 2.4.0
+=================
+
+  o Add new user configuration for the cache (#1950)
+
+  o docs: fix link to docker install instructions (#1952)
+
+  o Fix console warnings in newer python versions (#1958)
+
+  o Update github CI workflow actions (#1957)
+
+  o Fix `bst artifact show --long` for artifacts with symlinks (#1959)
+
+  o Fix race condition in public data handling (#1955)
+
+  o Cleanup deadcode (#1954)
+
+  o Make remote execution directory fetching more robust (#1962)
+
+  o Disable logging for frequent cache query jobs (#1963)
+
+  o Improve performance when using `storage-service` (#1966)
+
+  o Fixed issues with nested junctions (#1891, #1969, #1975)
+
+  o Drop support for Python 3.8 and add support for Python 3.13 (#1971)
+
+  o Load time optimization for commands which don't require cache queries (#1965)
+
+  o Address deprecation warnings from deprecated pkg_resources (#1948)
+
 =================
 buildstream 2.3.0
 =================
diff --git a/doc/source/using_config.rst b/doc/source/using_config.rst
index 0bc1ba62e..13768e117 100644
--- a/doc/source/using_config.rst
+++ b/doc/source/using_config.rst
@@ -199,6 +199,8 @@ Attributes
   ``reserved-disk-space`` can be specified in the same way as ``quota``, with
   the exception of the special ``infinity`` value. The default is ``5%``.
 
+  *Since: 2.4*
+
 * ``low-watermark``
 
   This controls how much of the cache should be retained on cleanup.
@@ -208,6 +210,8 @@ Attributes
   ``80%``, which means that when cleanup is triggered, 20% of the cache will
   be pruned by removing CAS objects that haven't been used recently.
 
+  *Since: 2.4*
+
 * ``pull-buildtrees``
 
   Whether to pull *build trees* when downloading remote artifacts.