Thank you for your feedback.
Form temporarily unavailable. Please try again or contact to submit your comments.

Email digests

Log in to subscribe to topics and get notified when content changes.

Email digests

An email digest is a single email that summarizes the activity for a selected notification and its target record during a specified time interval. You can enable an email digest to reduce the number of notifications received when frequent updates to the associated record occur within a short time period.

Figure 1. Example email digest
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 UI16 interface, since the email digest feature involves setting user notification preferences in the System Settings window.

Admins determine which notifications can be delivered in an email digest and configure the digest content for those notifications. Admins can also control 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
  1. 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).

  2. 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.