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.
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.
- 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.
- Review the base system digest intervals and if needed, create or modify intervals.
- 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.