Email digests

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 2 minutes to read
  • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Email Digests

    An email digest consolidates notifications related to a specific record over a defined time period into a single email. This feature helps reduce the volume of notifications users receive when multiple updates occur in quick succession. Email digests apply exclusively to email notifications and are not available for SMS, push notifications, or activity streams.

    Show full answer Show less

    Key Features

    • The Email Digest plugin is enabled by default in new and upgraded instances using the Core UI.
    • Admins can configure which notifications are included in a digest and set the content and intervals for these digests (e.g., hourly, daily).
    • Users can enable email digests and choose their preferred intervals in their notification preferences.
    • The system processes and sends out email digests approximately at the end of the selected interval.

    Key Outcomes

    By implementing email digests, organizations can streamline communication, ensure important updates are not missed, and enhance user experience by limiting redundant notifications. Admins should start by reviewing and modifying the default digest intervals, while users can enable and select their preferred digest settings to keep informed efficiently.

    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 Core UI 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.