diff --git a/docs/public-networks/reference/cli/options.md b/docs/public-networks/reference/cli/options.md
index 63a2367a32e..d039d13f418 100644
--- a/docs/public-networks/reference/cli/options.md
+++ b/docs/public-networks/reference/cli/options.md
@@ -1569,6 +1569,12 @@ min-block-occupancy-ratio="0.5"
 
 Minimum occupancy ratio for a mined block if the transaction pool is not empty. When filling a block during mining, the occupancy ratio indicates the threshold at which the node stops waiting for smaller transactions to fill the remaining space. The default is 0.8.
 
+:::note
+
+Besu ignores the `--min-block-occupancy-ratio` option for proof of stake networks (for example, Mainnet).
+
+:::
+
 ### `miner-coinbase`
 
 <!--tabs-->
diff --git a/versioned_docs/version-23.4.1/public-networks/reference/cli/options.md b/versioned_docs/version-23.4.1/public-networks/reference/cli/options.md
index 63a2367a32e..9046d56e893 100644
--- a/versioned_docs/version-23.4.1/public-networks/reference/cli/options.md
+++ b/versioned_docs/version-23.4.1/public-networks/reference/cli/options.md
@@ -1569,6 +1569,13 @@ min-block-occupancy-ratio="0.5"
 
 Minimum occupancy ratio for a mined block if the transaction pool is not empty. When filling a block during mining, the occupancy ratio indicates the threshold at which the node stops waiting for smaller transactions to fill the remaining space. The default is 0.8.
 
+:::note
+
+Besu ignores the `--min-block-occupancy-ratio` option for proof of stake networks (for example, Mainnet).
+
+:::
+
+
 ### `miner-coinbase`
 
 <!--tabs-->