diff --git a/docs/sample_config.yaml b/docs/sample_config.yaml
index 0c6be30e513dda64ee6e268ca91f0c78d9c8cdd0..4566d6db1c47f9fff610016126a14cc67e1ca681 100644
--- a/docs/sample_config.yaml
+++ b/docs/sample_config.yaml
@@ -510,6 +510,9 @@ log_config: "CONFDIR/SERVERNAME.log.config"
 #   - one for login that ratelimits login requests based on the account the
 #     client is attempting to log into, based on the amount of failed login
 #     attempts for this account.
+#   - one for ratelimiting redactions by room admins. If this is not explicitly
+#     set then it uses the same ratelimiting as per rc_message. This is useful
+#     to allow room admins to quickly deal with abuse quickly.
 #
 # The defaults are as shown below.
 #
@@ -531,6 +534,10 @@ log_config: "CONFDIR/SERVERNAME.log.config"
 #  failed_attempts:
 #    per_second: 0.17
 #    burst_count: 3
+#
+#rc_admin_redaction:
+#  per_second: 1
+#  burst_count: 50
 
 
 # Ratelimiting settings for incoming federation