diff --git a/docs/configuration/configuration.md b/docs/configuration/configuration.md
index 9095d130d..f83baa243 100644
--- a/docs/configuration/configuration.md
+++ b/docs/configuration/configuration.md
@@ -1287,8 +1287,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.