You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Learn how to configure SMTP settings for your Umbraco Cloud project to enable email functionality
4
+
for workflows, user invitations, and password resets.
5
+
---
6
+
1
7
# SMTP Settings
2
8
3
-
In many cases, you might want to send emails from your Umbraco Cloud project. It could be for inviting users to the Backoffice or as part of an Umbraco Forms Workflow. To do so, you will need to have a Simple Mail Transfer Protocol (SMTP) server and configure this in your `appsettings.json` file.
9
+
In many cases, you might want to send emails from your Umbraco Cloud project. This could be for inviting users to the Backoffice or as part of an Umbraco Forms Workflow. To do so, you need a Simple Mail Transfer Protocol (SMTP) server and must configure it in your `appsettings.json` file.
4
10
5
-
SMTP server is not included with your Umbraco Cloud project. You will need to have your SMTP server set up elsewhere and then you need to configure this service with your Umbraco Cloud project.
11
+
SMTP servers are not included with Umbraco Cloud projects. You will need to set up your own SMTP server elsewhere and configure it with your Umbraco Cloud project.
6
12
7
13
## Why Configure SMTP?
8
14
9
-
There are a handful of reasons why configuring an SMTP service on your Umbraco Cloud project could come in handy or might even be necessary.
15
+
Configuring an SMTP service for your Umbraco Cloud project enables email features like user invitations, password resets, and email workflows in Umbraco Forms.
10
16
11
17
### Umbraco Forms
12
18
13
-
When you are working with Umbraco Forms, you have the option to set up email workflows. This enables you to create forms that send out emails. It could be a contact form where your customers can send emails directly to you.
19
+
{% hint style="info" %}
20
+
**Legacy Umbraco**
14
21
15
-
To set up an email workflow to send out emails, you will need to configure the SMTP service. In some cases, you might also experience that you need to configure a _SenderEmail_ for notifications.
22
+
If your Cloud project runs Umbraco version 7 or 8, configure the _SenderEmail_ in the `<notifications>` section of the `web.config` file. For more information, see the [Legacy Documentation](https://our.umbraco.com/documentation/Reference/Configuration-for-Umbraco-7-and-8/umbracoSettings/).
23
+
{% endhint %}
16
24
17
-
Configure _SenderEmail_ in the `appsettings.json` file under `Umbraco:CMS:Global:Smtp`. For more details, see the [`Send Email`](https://docs.umbraco.com/umbraco-forms/editor/attaching-workflows/workflow-types#send-email) section in the Workflow Types article.
25
+
When working with Umbraco Forms, you can set up email workflows. This allows you to create forms that send out emails. For example, a contact form where customers can directly email you.
26
+
27
+
To set up an email workflow, you must configure the SMTP service. In some cases, you may also need to configure a _SenderEmail_ for notifications.
28
+
29
+
Configure _SenderEmail_ in the `appsettings.json` file under `Umbraco:CMS:Global:Smtp`. For more details, see the [Send Email](https://docs.umbraco.com/umbraco-forms/editor/attaching-workflows/workflow-types#send-email) section in the Workflow Types article.
18
30
19
31
```csharp
20
32
"Umbraco": {
@@ -28,30 +40,26 @@ Configure _SenderEmail_ in the `appsettings.json` file under `Umbraco:CMS:Global
28
40
},
29
41
```
30
42
31
-
{% hint style="info" %}
32
-
**Legacy Umbraco**
33
-
34
-
If your Cloud project is running Umbraco 7 or 8, the _SenderEmail_ is configured in the `<notifications>` section of the `web.config` file. Find more details on this in the [Legacy Documentation](https://our.umbraco.com/documentation/Reference/Configuration-for-Umbraco-7-and-8/umbracoSettings/).
35
-
{% endhint %}
36
-
37
43
### Backoffice Users
38
44
39
-
There are two scenarios for Backoffice users where configuring an SMTP service is needed:
45
+
You need to configure an SMTP service for Backoffice users in the following cases:
40
46
41
-
1. When you want to add a user to your project directly from the Backoffice. Doing this involves sending out an email to the new user. For this scenario, we've set up a fallback, which means that even though you haven't yet configured an SMTP service, an email will still be sent to the new user. Keep in mind that the fallback is **only** for this particular purpose; inviting users to join your project.
42
-
2. To set up the SMTP service for your Umbraco Cloud project if one of your Backoffice users has forgotten their password. To reset their password, they have to request a password reset which will be sent to them by mail. This will only work once you've configured an SMTP service.
47
+
***Inviting a New User** - When adding a user to your project from the Backoffice, an email invitation is sent. If you haven't set up an SMTP service, a fallback ensures the email is still delivered. However, this fallback only applies to user invitations.
48
+
***Password Resets** - If a Backoffice user forgets their password, they must request a reset link via email. This feature requires an SMTP service to be configured, as no fallback is available.
43
49
44
50
{% hint style="info" %}
45
51
By default, the option to request password resets for Backoffice Users is disabled on Umbraco Cloud projects. This is mainly to ensure that your Backoffice login stays in sync with your Umbraco ID.
46
52
{% endhint %}
47
53
48
-
You can reset your Umbraco ID password from the Umbraco Cloud login page. Find more details about Umbraco ID in the ['Users on Cloud'](users-on-cloud.md) article.
54
+
You can reset your Umbraco ID password from the Umbraco Cloud login page. Find more details on Umbraco ID, see the [Users on Cloud](users-on-cloud.md) article.
49
55
50
-
56
+
51
57
52
58
## Configure SMTP Settings
53
59
54
-
*[Sparkpost](https://www.sparkpost.com/) - quick to set up and developer-friendly.
60
+
Consider the following services for configuring your SMTP settings:
61
+
62
+
*[Sparkpost](https://developers.sparkpost.com/api/smtp/) - quick to set up and developer-friendly.
55
63
*[SendGrid](https://sendgrid.com/) - quick to set up.
56
64
*[MailGun](https://www.mailgun.com/) - mainly for developers, as it is a bit more on the technical side.
57
65
*[Rapidmail](https://www.rapidmail.com/) - EU-based and GDPR compliant.
@@ -60,12 +68,14 @@ You can reset your Umbraco ID password from the Umbraco Cloud login page. Find m
60
68
A video tutorial covering how to configure SMTP settings on an Umbraco Cloud project.
61
69
{% endembed %}
62
70
71
+
To configure SMTP:
72
+
63
73
1. Set up the SMTP server.
64
-
2. Configure the service:
74
+
2. Configure the service as follows:
65
75
66
76
{% tabs %}
67
77
{% tab title="Umbraco 10 +" %}
68
-
The SMTP is configured in the `Umbraco:CMS:Global:Smtp` section in your `appsettings.json` file.
78
+
For Umbraco 10 and above, configure SMTP in the `Umbraco:CMS:Global:Smtp` section in your `appsettings.json` file.
69
79
70
80
{% code title="appsettings.json" %}
71
81
```json
@@ -86,18 +96,18 @@ The SMTP is configured in the `Umbraco:CMS:Global:Smtp` section in your `appsett
86
96
```
87
97
{% endcode %}
88
98
89
-
To configure your SMTP service, enter the following details:
99
+
To configure the SMTP service, enter the following details:
90
100
91
-
***From**: The default address emails will be sent from.
92
-
***Host**: IP address or hostname for your SMTP service.
93
-
***Port**: The port of the SMTP host.
94
-
***SecureSocketOptions**: Allows you to specify what security should be used for the connection sending the email.
95
-
***Username**: Your username for the SMTP service.
96
-
***Password**: The password you use to access your SMTP service.
101
+
***From**: The default email address that will send out emails.
102
+
***Host**: The IP address or hostname for your SMTP service.
103
+
***Port**: The port number for your SMTP service.
104
+
***SecureSocketOptions**: Specifies the security used for the connection.
105
+
***Username**: Your SMTP service username.
106
+
***Password**: Your SMTP service password.
97
107
{% endtab %}
98
108
99
109
{% tab title="Legacy Umbraco (version 7 and 8)" %}
100
-
The SMTP is configured in the `system.net/mailSettings` section of the `web.config` file.
110
+
For legacy Umbraco (version 7 and 8), configure SMTP in the `system.net/mailSettings` section of the `web.config` file.
101
111
102
112
{% code title="web.config" %}
103
113
```xml
@@ -111,22 +121,22 @@ The SMTP is configured in the `system.net/mailSettings` section of the `web.conf
111
121
```
112
122
{% endcode %}
113
123
114
-
To configure your SMTP service you will need the following details:
124
+
To configure the SMTP service, provide the following details:
115
125
116
-
*The **host**: IP address or hostname for your SMTP service.
117
-
*The **userName**: Your username for the SMTP service.
118
-
*The **password**: The password you use to access your SMTP service.
126
+
***Host**: The IP address or hostname for your SMTP service.
127
+
***UserName**: Your SMTP service username.
128
+
***Password**: Your SMTP service password.
119
129
{% endtab %}
120
130
{% endtabs %}
121
131
122
132
123
133
124
134
{% hint style="info" %}
125
-
To make sure that your SMTP password is not visible in the `appSettings.json` file, you can use the [Secrets management](project-settings/secrets-management.md) feature to hide the setting by using the following key: `UMBRACO__CMS__GLOBAL__SMTP__PASSWORD.`
135
+
To keep your SMTP password secure, use the [Secrets management](project-settings/secrets-management.md) feature. This hides the setting by using the key: `UMBRACO__CMS__GLOBAL__SMTP__PASSWORD.`
126
136
{% endhint %}
127
137
128
-
Once you've configured these settings for your SMTP service, you can send emails from your Umbraco Cloud project. For more information on SMTP configuration, see the [Global Settings](https://docs.umbraco.com/umbraco-cms/reference/configuration/globalsettings#smtp-settings) article.
138
+
After configuring these settings, you can send emails from your Umbraco Cloud project. For more information on SMTP configuration, see the [Global Settings](https://docs.umbraco.com/umbraco-cms/reference/configuration/globalsettings#smtp-settings) article.
129
139
130
140
{% hint style="info" %}
131
-
You can test if you've configured your SMTP service correctly by running a [Health Check](https://docs.umbraco.com/umbraco-cms/extending/health-check) from the Umbraco Backoffice.
141
+
Test your SMTP configuration by running a [Health Check](https://docs.umbraco.com/umbraco-cms/extending/health-check) from the Umbraco Backoffice.
0 commit comments