Reference - SMTP server properties
When you define a new SMTP server or edit an existing one in the SMTP servers application, you can specify the following properties.
General | |
Server name | Specifies the domain name or IP address of the SMTP server. By default, the connection to the server uses port 25. To use a different port, include it in the server name. For example: 127.0.0.1:26 Enter localhost if you wish to use the server provided by your local machine. |
Priority | When an email (or batch of emails) needs to be sent out, the system checks the SMTP servers in the order of their priority and uses the first one that is available. As a result, servers with a higher priority receive a greater email load. The server with the highest priority for each website is the default SMTP server configured in Settings → System → Emails. If this server is busy or undefined, the email checks for any available server with the High priority, then Normal and finally Low. |
Enabled | Can be used to manually disable or enable the server (within the context of Xperience). A disabled server is skipped when outgoing emails check for available servers. |
Advanced | |
Delivery method | The delivery method for emails sent from the system:
|
Delivery method - Network
Username | The username used for authentication when connecting to the SMTP server. |
Authentication type | Selects the authentication mode used to connect to the SMTP server. The options are:
Many mail services are deprecating support of basic authentication, leaving OAuth as the only viable authentication type. A notable example is Microsoft Exchange Online, which begins disabling basic authentication after October 1, 2022 (see Deprecation of Basic authentication in Exchange Online). |
Password | Only applies when the Authentication type is set to Basic. Sets the password used together with the Username when connecting to the SMTP server. |
OAuth credentials | Only applies when the Authentication type is set to OAuth 2.0. Selects the OAuth credentials used for authentication. You can create and manage the credentials in the Email OAuth credentials application. See OAuth for email servers. |
Delivery method - Pickup directory
Pickup directory | Specifies a folder on the disk, where emails will be stored until the SMTP server processes them. The IIS_IUSRS group must be granted write permissions for this folder. |