diff --git a/docs/configuration/configuration.md b/docs/configuration/configuration.md
index 1da9843a31..d695c5920a 100644
--- a/docs/configuration/configuration.md
+++ b/docs/configuration/configuration.md
@@ -1288,8 +1288,8 @@ tls_config:
 
 # Configures the queue used to write to remote storage.
 queue_config:
-  # Number of samples to buffer per shard before we start dropping them.
-  [ capacity: <int> | default = 10000 ]
+  # Number of samples to buffer per shard before we block reading of more samples from the WAL.
+  [ capacity: <int> | default = 10 ]
   # Maximum number of shards, i.e. amount of concurrency.
   [ max_shards: <int> | default = 1000 ]
   # Minimum number of shards, i.e. amount of concurrency.