# User Email Notifications

DuploCloud supports system-generated email notifications for key user events, including welcome emails sent to new users when they're added to the system, and notification emails sent to specified recipients when a new admin user is added. This page explains how you to customize new user welcome emails, and configure new admin user emails.

## Customizing Welcome Emails for New Users

When a new user is added in DuploCloud, the system sends a welcome email. Complete the following steps to customize the email content.

1. Navigate to **Administrator** → **System Settings** → **System Config**.
2. Click **Add**. The **Add Config** pane displays.
3. In the **Config Type** list box, select **AppConfig**. 
4. In the **Key** field, select one of the following: 
   * **new\_user\_email\_subject**: to customize the subject line.
   * **new\_user\_email\_body**:  to customize the email body.
5. In the **Value** field, enter:
   * A plain text subject line (e.g., `Welcome to DuploCloud!`), or
   * An HTML-formatted email body (see example and formatting guidelines below).
6. Click **Submit**. The email subject line or body is customized. 

### **Example Email Body**

```html
Welcome to DuploCloud!<br /><br />
Your account has been created.<br /><br />
Username: {{username}}<br />
Login URL: {{env}}<br /><br />
Please reach out if you need help getting started.
```

{% hint style="info" %}
**Formatting Guidelines:**\
The **email subject** is plain text.\
The **email body** must be an **HTML-formatted string**.&#x20;

* Use `<br />` for line breaks.
* Use `&nbsp;` for extra spaces.
* Placeholders like `{{username}}` and `{{env}}` will be automatically filled in.
  {% endhint %}

## **Configuring New Admin User Email Notifications**&#x20;

When a new admin user is created in DuploCloud, you can configure the system to send an email notification for added visibility. This is especially useful for auditing and compliance purposes. To configure new admin user email notifications, first enable new admin notifications, and then choose the notification recipients.&#x20;

### **Enabling New Admin User Email Notifications**&#x20;

1. Navigate to **Administrator** -> **System Settings** -> **System Config**.
2. Click **Add**. The **Add Config** pane displays.<br>

   <div align="left"><figure><img src="https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FYyPkVb5hSG7z9V4I2jHx%2FScreenshot%20(379).png?alt=media&#x26;token=1cb20d77-6d7a-4e81-a15b-1f95b1c8038f" alt=""><figcaption><p>The <strong>Add Config</strong> pane</p></figcaption></figure></div>
3. Complete the fields as shown in the table below:

<table data-header-hidden><thead><tr><th width="150.888916015625"></th><th></th></tr></thead><tbody><tr><td><strong>Config Type</strong></td><td>Select <strong>Flags</strong></td></tr><tr><td><strong>Key</strong></td><td>Select <strong>Enable new admin notification</strong></td></tr><tr><td><strong>Value</strong></td><td>Select <strong>true</strong> to enable email notifications for new admin users.</td></tr></tbody></table>

4. Click **Submit** to save the setting. When the flag is set to **true**, an email will be sent to configured recipients (see steps below for configuring recipients) each time a new admin user is added.&#x20;

### Configuring New Admin Email Recipients

Configure which email addresses receive new admin user email notifications.

1. Navigate to **Administrator** → **System Settings** → **System Config**.
2. Click **Add**. The **Add Config** pane displays.<br>

   <div align="left"><figure><img src="https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FDFUkAnIsQi80lw7aABOv%2FScreenshot%20(469).png?alt=media&#x26;token=ce116088-1a5d-4b93-864f-3f4064be10d4" alt=""><figcaption><p>The <strong>Add Config</strong> pane</p></figcaption></figure></div>
3. Complete the fields as shown in the table below:

<table data-header-hidden><thead><tr><th width="150.888916015625"></th><th></th></tr></thead><tbody><tr><td><strong>Config Type</strong></td><td>Select <strong>AppConfig</strong></td></tr><tr><td><strong>Key</strong></td><td>Select <strong>Notification Admin Emails</strong></td></tr><tr><td><strong>Value</strong></td><td>Enter one or more email addresses, separated by semicolons (e.g., <code>admin1@example.com;admin2@example.com</code></td></tr></tbody></table>

4. Click **Submit** to save the setting. It may take up to 24 hours for the change to take effect. Once applied, the specified recipients will receive an email notification each time a new admin user is added.

{% hint style="warning" %}
Be careful when changing this setting, as it impacts who receives sensitive system notifications.
{% endhint %}