Email digests
An email digest is a single email that summarizes the activity for a selected notification and its target records during a specified time interval. You can enable an email digest to reduce the number of notifications received when frequent updates to the associated records occur within a short time period.
Email digest example that has a summary of incident comments
Note: Email digests apply to email notifications only and are not supported for SMS messages, push notifications, and activity streams.
How email digests work
In new and upgraded instances, the Email digest (com.glide.email_digest) plugin is activated by default. Your instance must use the Core UI interface, since the email digest feature involves setting user notification preferences.
Admins determine which notifications can be delivered in an email digest and configure the digest content for those notifications. They also set the intervals for digests. An interval is the length of time that notifications are collected for the digest, such as daily or hourly.
Users enable the digest and select the digest interval for a specific notification in their notification preferences. The system accumulates the notifications that normally would be sent during the specified interval and summarizes them in the email digest.
When processing an email digest, the system:
- Stores the digest configuration for the notification in the Notifications [sysevent_email_action] table.
- Temporarily stores the notification content accumulated for a user in the Email Digest Parts [sys_email_digest_part] table and the Email Digest Part Users [sys_email_digest_part_user] table.
Runs an email digest job every 15 minutes to check when a digest is ready to be sent to a user.
The system uses the digest interval to determine when the digest is ready to be sent. The digest interval begins when the first notification is triggered for the user and stops at the end of the interval time.
Sends the email digest to the user soon after the selected digest interval ends.
For example, if a user selects an hourly digest interval and the first notification is triggered at 08:15, the interval starts at 08:15. When the digest interval ends, the system generates the email digest approximately one hour later, at about 09:15 or shortly after, depending on when the email digest job ran.
Set up email digests
What to do — admins
Review the base system digest intervals and if needed, create or modify intervals.
The base system digest intervals are one day (24 hours), one hour, every four hours, and seven days (weekly).
Determine the email notifications that can be delivered in a digest and configure the email digest content for those notifications.
When determining which notifications are appropriate for an email digest, consider the notification content and intervals that your users can select. For example, digests that can be generated weekly might be better suited for notifications that are non-urgent.
What to do — all users
For a notification that can be delivered in an email digest, enable the email digest in your notification preferences (Notifications tab in the System Settings window). You also specify the interval time that the notifications are accumulated.
Next step
If you are an admin, begin the digest setup process by reviewing the base system email digest intervals and create or modify the intervals.
Create or modify email digest intervals
Admins can create or modify the email digest intervals (length of time) during which activity for a selected notification is accumulated in an email digest. Users select a digest interval when they enable an email digest in their notification preferences.- Configure email digests
Use the Notification form to create or modify the content of an email digest for a notification. You can also disable the email digest for a notification so that it isn’t available in the notification preferences of your users. - Enable email digest in Next Experience
Reduce the number of email notifications you receive by enabling email digest notifications. An email digest is a single email that summarizes the activity for a selected notification and its target record during a specified time interval. - Enable an email digest in Core UI
Reduce the number of notifications you receive for a selected target record during a specified time interval by enabling an email digest. The digest is a single email that collects individual notifications for a targeted record generated during the specified interval. The email digest of two different target records will not be clubbed in a single email.
Parent Topic:Email and SMS notifications
Related topics
Create notification categories
Watermarks on notification emails