diff --git a/sentry/config.example.yml b/sentry/config.example.yml
index 298929958f1..951916c5e4e 100644
--- a/sentry/config.example.yml
+++ b/sentry/config.example.yml
@@ -13,9 +13,15 @@ mail.host: 'smtp'
 # mail.username: ''
 # mail.password: ''
 # mail.use-tls: false
+# mail.use-ssl: false
 # The email address to send on behalf of
 # mail.from: 'root@localhost'
 
+# The mailing list namespace for emails sent by this Sentry server.
+# This should be a domain you own (often the same domain as the domain
+# part of the `mail.from` configuration parameter value) or `localhost`.
+# mail.list-namespace: 'localhost'
+
 # If you'd like to configure email replies, enable this.
 # mail.enable-replies: true