diff --git a/nearcore/src/config.rs b/nearcore/src/config.rs
index 8563574bf33..8b9a92c49c9 100644
--- a/nearcore/src/config.rs
+++ b/nearcore/src/config.rs
@@ -340,6 +340,10 @@ pub struct Config {
     pub state_sync: Option<StateSyncConfig>,
     /// Limit of the size of per-shard transaction pool measured in bytes. If not set, the size
     /// will be unbounded.
+    /// New transactions that bring the size of the pool over this limit will be rejected. This
+    /// guarantees that the node will use bounded resources to store incoming transactinos.
+    /// Setting this value too low (<1MB) on the validator might lead to production of smaller
+    /// chunks and underutilizing the capacity of the network.
     #[serde(default = "default_transaction_pool_size_limit")]
     pub transaction_pool_size_limit: Option<u64>,
 }