# Mail

The notification provider *Email* in Eliona 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://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/ZmgDy7HsUJkpMVElVsbZ/email.png" 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="270.20001220703125">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 through which emails are sent.</td></tr><tr><td>A3</td><td>Sender Name</td><td>Name displayed as the sender in emails.</td></tr><tr><td>A4</td><td>Sender Email</td><td>Email address used as the sender.</td></tr><tr><td>A5</td><td>Authentication required</td><td>Enable/disable whether SMTP authentication is used.</td></tr><tr><td>A6</td><td>Users</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>SMTP server port (e.g. 25, 465 or 587).</td></tr><tr><td>A9</td><td>Pool</td><td>Enables sending via an SMTP pool.</td></tr><tr><td>A10</td><td>Secure</td><td>Enables the use of a secure connection (STARTTLS/SSL).</td></tr><tr><td>A11</td><td>Strict SSL/TLS</td><td>Forces 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 the SMTP server is configured correctly, otherwise no emails can be sent.
{% endhint %}

## **Email Templates**

Eliona allows you to customize individual email templates for different notifications. This applies not only to **alarm emails**, but also to ***Ticket E-Mail Content*** and ***Password Reset E-Mail 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://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/EXPvmDjCj4oXeFyuvddV/image.png" alt="" data-size="line"> on the right in the **template \[C]**&#x74;o edit a pre-made template.

{% content-ref url="../../../../academy/twig-templating-in-eliona" %}
[twig-templating-in-eliona](https://docs.buildings.ability.abb/collection/english-v14/academy/twig-templating-in-eliona)
{% endcontent-ref %}

<div data-full-width="true"><figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/YErItK8uwcTEfcjds8Lc/email%20(1).png" alt=""><figcaption></figcaption></figure></div>

### **Override default**:

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

### Change email subject

As soon as the option **"Override default"** is enabled, you can customize the subject of the email **\[E]** . Enter a custom subject here that will be used for all future alarm emails.

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

### **Edit format & style**:

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

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

**Alarm E-Mail Content**: Is used for notifications sent via triggered alarms.

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

**Password Reset E-Mail 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 inserting 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 at the bottom left on **Save,** to ensure that all future emails use the updated content.

{% hint style="info" %}
Test the customized template after each change to make sure it is displayed correctly and that there are no syntax errors in the HTML code.
{% endhint %}