diff --git a/doc/release-notes-31384.md b/doc/release-notes-31384.md
new file mode 100644
index 00000000000..0cfb44956f4
--- /dev/null
+++ b/doc/release-notes-31384.md
@@ -0,0 +1,17 @@
+- Node and Mining
+
+---
+
+- PR #31384 fixed an issue where the coinbase transaction weight was being reserved in two different places.
+  The fix ensures that the reservation happens in a single place.
+
+- This specifies how many weight units to reserve for the coinbase transaction.
+
+- Upgrade note: the default of `-maxcoinbaseweight` ensures backward compatibility for users who did
+  not override `-blockmaxweight`.
+
+- If you previously configured `-blockmaxweight=4000000` then you can
+  safely set `-maxcoinbaseweight=4000` to maintain existing behavior.
+
+- Bitcoin Core will now **fail to start** if the `-blockmaxweight` or `-maxcoinbaseweight` init parameter exceeds
+  the consensus limit of `4,000,000` weight units.