HomeDev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunitySubmit a ticketLog In
GitHubNuGetDev CommunitySubmit a ticket

Email notifications

Describes how to configure email notifications for content approvals.

Emails for content approval notifications can be configured to be sent immediately or periodically as a batch.

📘

Note

You need to configure the SMTP settings for Optimizely Content Management System (CMS) to send out email notifications, see Configure your email server.

The behavior of content approval notification emails before CMS 11.13.0 was to send an email immediately for each notification. This can lead to many emails being sent, depending on how the content approvals are configured, which can be experienced by users as the system spamming them. As of CMS 11.13.0, the behavior is sending users emails periodically. This means that notifications are batched into a single email sent regularly.

As of CMS 11.13.0, you can configure content approval notification emails to be sent immediately or periodically to users.

Because the content approval notification emails are sent periodically by default, configuration is only needed when this is not the desired behavior. To configure emails to be sent immediately, the ApprovalNotificationOptions must be configured accordingly. This should be done during application initialization. Configuring the dispatch interval for emails is handled in the scheduled job; see the notification dispatcher job section below.

The following is an example of how the options can be configured during application initialization. A module dependency on FrameworkInitialization is required to ensure correct execution order.

[InitializableModule]
[ModuleDependency(typeof (FrameworkInitialization))]
public class ApprovalNotificationInitialization: IConfigurableModule {
  public void ConfigureContainer(ServiceConfigurationContext context) {
    context.Services.Configure < ApprovalNotificationOptions > (options => options.Immediate = true);
  }
}

A scheduled job, Notification Dispatcher, dispatches notification emails at regular intervals. If content approval notification emails are configured to be sent periodically, then the configuration of the scheduled job determines the interval for email dispatches.

The job is enabled by default and set to run every 30 minutes.