user docs: Document message notification email custom batching.

Also adjust the label slightly for better readability.

Co-authored-by: Tim Abbott <tabbott@zulip.com>
This commit is contained in:
Alya Abbott 2021-09-10 15:15:01 -07:00 committed by Tim Abbott
parent 8729e658b7
commit 9df8fbde48
2 changed files with 50 additions and 1 deletions

View File

@ -110,7 +110,7 @@
<div class="alert-notification"></div> <div class="alert-notification"></div>
<label for="email_notifications_batching_period"> <label for="email_notifications_batching_period">
{{t "Batching period for email notifications" }} {{t "Delay before sending message notification emails" }}
</label> </label>
<div class="input-group"> <div class="input-group">

View File

@ -1,5 +1,46 @@
# Configure message notification emails # Configure message notification emails
Zulip can be configured to send message notification emails for [PMs
and mentions](/help/pm-mention-alert-notifications), as well as
[stream messages](/help/stream-notifications).
You can [respond to Zulip messages directly][reply-from-email] by replying to message
notification emails, unless you are
connecting to a self-hosted Zulip server whose system administrator
has not configured the [incoming email gateway][incoming-email-gateway].
[incoming-email-gateway]: https://zulip.readthedocs.io/en/latest/production/email-gateway.html
## Delay before sending emails
To reduce the number of emails you receive, Zulip
delays sending message notification emails for a configurable period
of time (default: 2 minutes). The delay
helps in a few ways:
* No email is sent if you return to Zulip and read the message before
the email would go out.
* Edits made by the sender soon after sending a message will be
reflected in the email.
* Multiple messages in the same Zulip conversation are combined into
a single email. (Different conversations will always be
in separate emails, so that you can
[respond directly from your email][reply-from-email]).
[reply-from-email]: /help/using-zulip-via-email
To configure the delay for message notification emails:
{start_tabs}
{settings_tab|notifications}
1. Under **Other notification settings**, select the desired time period from the
**Delay before sending message notification emails** dropdown.
{end_tabs}
## Include organization name in subject line ## Include organization name in subject line
If you belong to multiple Zulip organizations, it can be helpful to have the If you belong to multiple Zulip organizations, it can be helpful to have the
@ -14,6 +55,7 @@ name of the organization in the subject line of your message notification emails
{end_tabs} {end_tabs}
## Hide message content ## Hide message content
For security or compliance reasons, you may want to hide the content of your For security or compliance reasons, you may want to hide the content of your
@ -32,3 +74,10 @@ being sent through your email.
**Include message content in message notification emails**. **Include message content in message notification emails**.
{end_tabs} {end_tabs}
## Related articles
* [Using Zulip via email](/help/using-zulip-via-email)
* [Message a stream by email](/help/message-a-stream-by-email)
* [Stream notifications](/help/stream-notifications)
* [Hide message content in emails (for organizations)](/help/hide-message-content-in-emails)