Loading...
Area: Optimizely CMS
Applies to versions: 10 and higher
Other versions:
ARCHIVED This content is retired and no longer maintained. See the version selector for other versions of this topic.

Configuring your email server

Recommended reading 
Note: This documentation is for the preview version of the upcoming release of CMS 12/Commerce 14/Search & Navigation 14. Features included here might not be complete, and might be changed before becoming available in the public release. This documentation is provided for evaluation purposes only.

For Optimizely CMS to send out email notifications, (for example, to users who are working with projects or content approvals), or if you are using Optimizely Forms and want to send emails from form postings, you need to configure your email server.

Note: If you are using Optimizely Digital Experience Platform  (DXP), see Configuring the email server for more information on how to configure the email server for your websites.

How it works

Specify an SMTP server endpoint that is reachable from the site and is allowed to send emails using the specified from-address. The from-adress is only used as fallback and can be overridden by, for example, notifications, forms, or any other features using the SMTP functionality built into .NET.

Configure settings in web.config:

{
   "EPiServer":{
     "Smtp":{
          "DeliveryMethod":"NetWork",
          "Network":{
             "Host":smtp.example.com,
             "Port": "25",
             "UserName":"user name",
             "Password": "password",
             "UseSsl": "true/false" 
          },
         "SpecifiedPickupDirectory":"Pickup directory to place email files in"
     }
   }
}

For reference, see the MSDN article <smtp> Element (Network Settings).

Default sender for notifications (optional)

Default settings for the sender in Optimizely notifications can be configured as follows: specify an email address and display name to be used in, for example, project or content approval notifications to editors. Note that these are defaults. It is possible for a notification to override these defaults with a custom sender. If NotificationEmailAddress is not specified, the from-attribute on the email settings described above are used; if no adress is found, it is not possible to send notifications to users.

{
  "EPiServer":{
     "Cms":
        "NotificationOptions":{
            "NotificationEmailAddress":"System default email address for notification emails.",
            "NotificationEmailDisplayName":"System default sender name for no notification emails. default value is Optimizely"         
        }
      }
   }
}
Do you find this information helpful? Please log in to provide feedback.

Last updated: Jul 02, 2021

Recommended reading