orchardcore-email

OrchardCore.Email Module

OrchardCore.Email supplies the provider-neutral email API. Enable an email provider and configure one enabled provider as the default before application code sends mail.

Provider module	Tenant provider technical name	Configuration-backed default
OrchardCore.Email.Smtp	SMTP	DefaultSMTP
OrchardCore.Email.Azure	Azure	DefaultAzure

The email settings page is Settings → Communication → Email. It lists enabled providers and selects EmailSettings.DefaultProviderName. Enabling the last valid tenant provider selects it automatically; otherwise explicitly choose the default. The test page is Tools → Testing → Email Test and lets an administrator select an enabled provider for the test message.

Enable and Configure SMTP

{
  "steps": [
    {
      "name": "Feature",
      "enable": [
        "OrchardCore.Email",
        "OrchardCore.Email.Smtp"
      ]
    },
    {
      "name": "Settings",
      "SmtpSettings": {
        "IsEnabled": true,
        "DefaultSender": "[email protected]",
        "Host": "smtp.example.com",
        "Port": 587,
        "AutoSelectEncryption": false,
        "EncryptionMethod": "STARTTLS",
        "RequireCredentials": true,
        "UserName": "smtp-user",
        "Password": "use-a-secret-provider",
        "DeliveryMethod": "Network"
      },
      "EmailSettings": {
        "DefaultProviderName": "SMTP"
      }
    }
  ]
}

OrchardCore_Email_Smtp configures the DefaultSMTP provider. Use the settings UI for a tenant-specific SMTP provider. Do not commit credentials.

Enable and Configure Azure Communication Services

{
  "steps": [
    {
      "name": "Feature",
      "enable": [
        "OrchardCore.Email",
        "OrchardCore.Email.Azure"
      ]
    },
    {
      "name": "Settings",
      "AzureEmailSettings": {
        "IsEnabled": true,
        "DefaultSender": "[email protected]",
        "ConnectionString": "supply-from-a-secure-source"
      },
      "EmailSettings": {
        "DefaultProviderName": "Azure"
      }
    }
  ]
}