# Mail

The *E-mail* notification provider in BuildingPro Suites enables the configuration and management of email notifications to send alarms and other notifications via an email system.

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F9bfnbdfcu7gtPSs3WGna%2Femail.png?alt=media&#x26;token=21a7db7b-9509-4ec4-b8fb-57e4ff07a374" alt=""><figcaption></figcaption></figure></div>

## Configuration

Navigate to: **Engineering → Notifications Providers → E-mail**

In the view **\[A]**, the following options are available:

<table data-full-width="true"><thead><tr><th width="66.19998168945312">No.</th><th width="219">Field / Option</th><th>Description</th></tr></thead><tbody><tr><td>A1</td><td>Note</td><td>Internal note for this configuration.</td></tr><tr><td>A2</td><td>Host</td><td>SMTP server via which emails are sent.</td></tr><tr><td>A3</td><td>Sender Name</td><td>Name that is displayed as the sender in emails.</td></tr><tr><td>A4</td><td>Sender Email</td><td>Email address that is used as the sender.</td></tr><tr><td>A5</td><td>Authentication required</td><td>Activate/deactivate whether SMTP authentication is used.</td></tr><tr><td>A6</td><td>User</td><td>Username / email address for SMTP authentication.</td></tr><tr><td>A7</td><td>Password</td><td>Password for SMTP authentication.</td></tr><tr><td>A8</td><td>Port</td><td>Port of the SMTP server (e.g. 25, 465, or 587).</td></tr><tr><td>A9</td><td>Pool</td><td>Activates sending via an SMTP pool.</td></tr><tr><td>A10</td><td>Secure</td><td>Activates the use of a secure connection (STARTTLS/SSL).</td></tr><tr><td>A11</td><td>Strict SSL/TLS</td><td>Enforces a strict SSL/TLS connection.</td></tr><tr><td>A12</td><td>Rate Limit</td><td>Maximum allowed number of emails per defined interval.</td></tr><tr><td>A13</td><td>Rate Delta</td><td>Time interval for the rate limit in seconds.</td></tr><tr><td>A14</td><td>Max Connections</td><td>Maximum number of simultaneous SMTP connections.</td></tr><tr><td>A15</td><td>Save</td><td>Apply changes to the configuration.</td></tr></tbody></table>

{% hint style="info" %}
Make sure that the SMTP server is set up correctly, otherwise no emails can be sent.
{% endhint %}

## E-mail Templates

BuildingPro Suites allows you to customize individual email templates for various notifications. This applies not only to **alarm emails** but also to ***Ticket Email Content*** and ***Password Reset Email Content***. By customizing these templates, you can optimally tailor the design, style, and content of your emails to your needs.

Click on <img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FEbbuNfEueICryAY1kvFh%2Fimage.png?alt=media&#x26;token=a29e66fc-95f3-4311-a2c4-a6af063ec2df" alt="" data-size="line"> on the right in the **Template \[C]** to edit a pre-built template.

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FA6YY7ErPJXIzWSKMzxoa%2Femail%20(1).png?alt=media&#x26;token=20c8a198-cb5b-40f7-8357-fa3f7a984fa2" alt=""><figcaption></figcaption></figure></div>

### Override standard

To customize the selected template, select the **Override standard \[D]** option. This allows you to make individual changes to the template instead of using the standard template.

### Change email subject

Once the **"Override standard"** option is activated, you can customize the subject of the email **\[E]**. Enter an individual subject here that will be used for all future alarm emails.

◈ *Only alarm variables can be used in the email subject:*[ → Alarm Template](https://docs.buildings.ability.abb/collection/academy/twig-templating-in-eliona#alarm-template): Available Variables.\
▷ *The subject of ticket and password reset emails is fixed and cannot be changed.*

### Edit format & style

{% hint style="info" %}
You can find which variables can be specifically customized here: [↗ Templates](https://docs.buildings.ability.abb/collection/academy/twig-templating-in-eliona)
{% endhint %}

Under **Alarm Email Content \[F]**, **Ticket Email Content**, or **Password Reset Email Content**, you can edit the HTML code of the respective email. This code determines the layout, colors, and structure of the email.

**Alarm Email Content**: Is used for notifications that are sent about triggered alarms.

**Ticket Email Content**: Is used for emails that are sent as part of the ticket system, e.g., to inform about newly created tickets or status changes.

**Password Reset Email Content**: This template is used for password reset emails when a user resets their password.

With HTML and CSS, you can make changes to the design and formatting, such as the font, colors, or the insertion of images:

```html
<h2 style="color: #4CAF50;">New Alarm: [Alarm type]</h2>
<p>An alarm was triggered at [Alarm time].</p>
<p>Details:</p>
<ul>
  <li><strong>Alarm ID:</strong> [Alarm ID]</li>
  <li><strong>Priority:</strong> [Alarm priority]</li>
</ul>
```

After you have edited the template, click on Save in the bottom left to ensure that all future emails use the updated content.

{% hint style="info" %}
Test the customized template after every change to ensure that it is displayed correctly and does not contain any syntax errors in the HTML code.
{% endhint %}