Configure notification profiles

Overview

Notification service enables you to use different sender profiles. Each profile contains specific SMTP settings which determine the sending channel to be used. The system can be configured to use different profiles for different modules. For example, you may want to configure one default sender email address for your Email campaigns module, and a different one for comment notifications, or forum post notification. To achieve that you need to create two notification profiles, each with the desired default sender email address and then specify in the corresponding module settings which notification profile to be used.

Notification profile settings

When configuring a notification profile, you can choose to set up an existing profile, or create a new one and set it up. To configure a notification profile, follow these steps:

1. In the main menu, click Administration » Settings » Advanced.
2. In the treeview on the left, click Notifications » Profiles
3. Select one of the existing profiles to configure it. Alternatively, you can click on Create new »SmtpSenderProfileElement to create a new profile and configure it/
4. Configure the following properties:

   DefaultSenderEmailAddress	Enter the desired email address that will be used by Sitefinity CMS to specify the From: email address for outgoing emails.
   Host	This property defines the SMTP server (host) address that Sitefinity CMS should use to send emails over SMTP protocol. Enter the name or IP address of the SMTP server.
   Port	Enter the port used for SMTP transactions. You set the port separately for each notification profile. Use the port that your SMTP provider requires, and set UseSSL accordingly. The Default profile uses port 25. The predefined SendGrid, Mandrill, and MailGun profiles use port 587, but their UseAuthentication and UseSSL checkboxes are cleared, so you must configure them before you use these profiles.
   UseAuthentication	Select this checkbox if your SMTP server requires a username and password to be provided to authenticate the connection to it. If this checkbox is selected, the values in the Username and Password textboxes are used.
   Username	Enter the user name of the account that you use to connect to the SMTP server.
   Password	Enter the password of the account that you use to connect to the SMTP server.
   Domain (optional)	Enter the domain or computer name that verifies the credentials.
   UseSSL	Select this checkbox to encrypt the connection with STARTTLS, which usually uses port 587. Port 465 is not supported. If your provider, for example, Gmail, lists port 465, use port 587 instead.
   BatchSize (optional)	Specify the number of emails Sitefinity CMS processes as one batch when sending message jobs.
   BatchPauseInterval (optional)	Enter the interval (in seconds) between sending batches.
   DeliveryMethod (optional)	Select the method for handling outgoing email: Network – this is the default method PickupDirectory PickupDirectoryFromIis
   PickupDirectoryLocation (optional)	Specify the folder where applications save mail messages to be processed by the local SMTP server. If PickupDirectory or PickupDirectoryFromIis is specified as DeliveryMethod, Sitefinity CMS uses this value to locate the directory to be used for outgoing email.
   Timeout (optional)	Enter the amount of time (in milliseconds) after which a message job times out.
   EmailSubjectEncoding (optional)	Specify the encoding of the Subject to be used when sending out emails.
   EmailBodyEncoding (optional)	Specify the encoding of the Body to be used when sending out emails.
   ProfileName	Enter the desired name of the notification profile.
   SenderType (optional)	Enter the CLR type of the email sender to be used for this notification profile. By default, this value is Telerik.Sitefinity.Services.Notifications.Smtp.SmtpSender.
   ProfileType (optional)	This property specifies usage of SMTP profile. By default, its value is smtp. Only this value is supported.

   Change the default notification profile globally

   Sitefinity CMS enables you to specify which notification profile to be used by default. This way, unless you have changed the notification settings of a module, all system modules that send out emails and notification use the profile you configure to be default. To specify which notification profile to be used by default follow the instructions below:

   1. In the main menu, click Administration » Settings » Advanced.
   2. In the treeview on the left, click Notifications » DefaultProfiles
   3. In the ProfileName textbox type the name of the notification profile you want to be used as default for the system
   4. Click Save changes

   Change the default notification profile on a module level

   By default, all system modules use the Default notification profile. If you need to use different profiles for different modules, you can specify which notification profile to be used on a module level. If you specify a notification profile on a module level, the module starts using the specified profile, instead of the default profile configured on a global level.

   Following is a list of modules where you can specify a notification profile:

   • Forums
   • Forms
   • Email campaigns
   • Password recovery
   • Site shield