diff --git a/doc/src/sgml/release-18.sgml b/doc/src/sgml/release-18.sgml
index d7340465e79..19e770c65b5 100644
--- a/doc/src/sgml/release-18.sgml
+++ b/doc/src/sgml/release-18.sgml
@@ -192,6 +192,27 @@ Change pg_backend_memory_contexts.level and pg_log_backend_memory_contexts() to
These were previously zero-based.
+
+
+
+
+
+
+initdb defaults to enabling data checksums
+§
+
+
+
+The previous default behavior (checksums disabled) can be obtained using the
+new option --no-data-checksums. Note that pg_upgrade will reject upgrading
+between clusters with different checksum settings, so if the old cluster does
+not have checksums enabled (the previous default), then the new cluster will
+need to be initialized with --no-data-checksums in order to allow pg_upgrade
+to succeed.
+