# Email templates

The following Orbit actions will generate an email:

- A reset password request
- Sharing an Orbit item
- Stop sharing an item
- Shared item updated
- New user registration
- Account locked

Orbit includes a set of default email templates for each action.

You can create your own custom email templates by adding a modified set of files to the emailTemplates folder.

> [!NOTE]
>
> The standard location is `C:\inetpub\wwwroot\OrbitAPI\emailTemplates`, but you can change it in the settings.

## Creating your own email templates

To create a custom email that persists between updates, rename the file: remove the `Template` suffix and add the `Custom` prefix.

The default file names are:

- ResetPasswordRequestNotificationEmailTemplate.html
- SharedNotificationEmailTemplate.html
- UnsharedNotificationEmailTemplate.html
- UpdatedShareNotificationEmailTemplate.html
- UserRegistrationRequestNotificationEmailTemplate.html
- AccountLockedEmailTemplate.html

The equivalent custom file names are:

- CustomResetPasswordRequestNotificationEmail.html
- CustomSharedNotificationEmail.html
- CustomUnsharedNotificationEmail.html
- CustomUpdatedShareNotificationEmail.html
- CustomUserRegistrationRequestNotificationEmail.html
- CustomAccountLockedEmail.html

> [!NOTE]
>
> Orbit recreates the default files on each release, but leaves any custom files untouched.

Orbit also includes text versions of the files. It doesn't use the `.txt` version of a file if a `.html` version is present. It also doesn't use a default file if a custom file is present. Orbit checks for files in the following order, and uses the first one it finds:

`CustomSharedNotificationEmail.html` \> `CustomSharedNotificationEmail.txt` \> `SharedNotificationEmailTemplate.html` \> `SharedNotificationEmailTemplate.txt`

Text Only

```text
{{User.Firstname}} has shared {{Shareable.Title}} with you
<!DOCTYPE html>
<html>
<head>
    <title></title>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" >
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <meta http-equiv="X-UA-Compatible" content="IE=edge" >
    <style type="text/css">
        /* FONTS */
        @media screen {
            @font-face {
                font-family: 'Lato';
                font-style: normal;
                font-weight: 400;
                src: local('Lato Regular'), local('Lato-Regular'), url(https://fonts.gstatic.com/s/lato/v11/qIIYRU-oROkIk8vfvxw6QvesZW2xOQ-xsNqO47m55DA.woff) format('woff');
            }

            @font-face {
                font-family: 'Lato';
                font-style: normal;
                font-weight: 700;
                src: local('Lato Bold'), local('Lato-Bold'), url(https://fonts.gstatic.com/s/lato/v11/qdgUG4U09HnJwhYI-uK18wLUuEpTyoUstqEm5AMlJo4.woff) format('woff');
            }

            @font-face {
                font-family: 'Lato';
                font-style: italic;
                font-weight: 400;
                src: local('Lato Italic'), local('Lato-Italic'), url(https://fonts.gstatic.com/s/lato/v11/RYyZNoeFgb0l7W3Vu1aSWOvvDin1pK8aKteLpeZ5c0A.woff) format('woff');
            }

            @font-face {
                font-family: 'Lato';
                font-style: italic;
                font-weight: 700;
                src: local('Lato Bold Italic'), local('Lato-BoldItalic'), url(https://fonts.gstatic.com/s/lato/v11/HkF_qI1x_noxlxhrhMQYELO3LdcAZYWl9Si6vvxL-qU.woff) format('woff');
            }
        }

        /* CLIENT-SPECIFIC STYLES */
        body, table, td, a {
            -webkit-text-size-adjust: 100%;
            -ms-text-size-adjust: 100%;
        }

        table, td {
            mso-table-lspace: 0pt;
            mso-table-rspace: 0pt;
        }

        img {
            -ms-interpolation-mode: bicubic;
        }

        /* RESET STYLES */
        img {
            border: 0;
            height: auto;
            line-height: 100%;
            outline: none;
            text-decoration: none;
        }

        table {
            border-collapse: collapse !important;
        }

        body {
            height: 100% !important;
            margin: 0 !important;
            padding: 0 !important;
            width: 100% !important;
        }

        /* iOS BLUE LINKS */
        a\[x-apple-data-detectors\] {
            color: inherit !important;
            text-decoration: none !important;
            font-size: inherit !important;
            font-family: inherit !important;
            font-weight: inherit !important;
            line-height: inherit !important;
        }

        /* MOBILE STYLES */
        @media screen and (max-width:600px) {
            h1 {
                font-size: 32px !important;
                line-height: 32px !important;
            }
        }

        /* ANDROID CENTER FIX */
        div\[style*="margin: 16px 0;"\] {
            margin: 0 !important;
        }

        .shareable-button:visited,
        .shareable-button:focus,
        .shareable-button:active {
            color: #ffffff;
        }
    </style>
</head>
<body style="background-color: #f4f4f4; margin: 0 !important; padding: 0 !important;">

    <table border="0" cellpadding="0" cellspacing="0" width="100%">

        <tr>
            <td bgcolor="#02bff6" align="center">

                <table border="0" cellpadding="0" cellspacing="0" width="100%" style="max-width: 600px;">
                    <tr>
                        <td align="center" valign="top" style="padding: 40px 10px 40px 10px;">
                            <img alt="Logo" src="../{{StaticResources.BaseUrl}}logo-orbit-apteco-white-01.png" width="180" border="0">
                        </td>
                    </tr>
                </table>

            </td>
        </tr>

        <tr>
            <td bgcolor="#02bff6" align="center" style="padding: 0px 10px 0px 10px;">

                <table border="0" cellpadding="0" cellspacing="0" width="100%" style="max-width: 600px;">
                    <tr>
                        <td bgcolor="#ffffff" align="center" valign="top" style="padding: 40px 20px 20px 20px; border-radius: 4px 4px 0px 0px; color: #111111; font-family: 'Lato', Helvetica, Arial, sans-serif; font-size: 48px; font-weight: 400;  line-height: 24px;">
                            <h1 style="font-size: 24px; font-weight: 400; margin: 0;">Orbit share</h1>
                        </td>
                    </tr>
                </table>

            </td>
        </tr>

        <tr>
            <td bgcolor="#f4f4f4" align="center" style="padding: 0px 10px 0px 10px;">

                <table border="0" cellpadding="0" cellspacing="0" width="100%" style="max-width: 600px;">

                    <tr>
                        <td bgcolor="#ffffff" align="left" style="padding: 0px 30px 15px 30px; color: #666666; font-family: 'Lato', Helvetica, Arial, sans-serif; font-size: 16px; font-weight: 400; ">
                            <p style="margin: 0;">Hi,
                        </td>
                    </tr>

                    <tr>
                        <td bgcolor="#ffffff" align="left" style="padding: 0px 30px 20px 30px; color: #666666; font-family: 'Lato', Helvetica, Arial, sans-serif; font-size: 16px; font-weight: 400;">
                            <p style="margin: 0;">{{User.Firstname}} has shared the Apteco Orbit {{Shareable.ShareableTypeLowercase}} <a href="../{{Shareable.Url}}" target="_blank" style="color: #02bff6; text-decoration: none;">{{Shareable.Title}}</a>, from the <span style="color: #000000;">'{{Api.DataView}}'</span> DataView with you.
                        </td>
                    </tr>

                    <tr>
                        <td bgcolor="#ffffff" align="left" style="padding: 0px 50px 20px 50px; color: #666666; font-family: 'Lato', Helvetica, Arial, sans-serif; font-size: 16px; font-weight: 400;">
                            <p style="margin: 0;"><pre style="font-family: 'Lato', Helvetica, Arial, sans-serif; font-style: italic; font-size: 16px; line-height: 1em;">{{Shareable.UpdateMessage}}</pre>
                        </td>
                    </tr>

                    <tr>
                        <td bgcolor="#ffffff" align="left" style="padding: 0px 30px 40px 30px; color: #666666; font-family: 'Lato', Helvetica, Arial, sans-serif; font-size: 16px; font-weight: 400; ">
                            <p style="margin: 0;"><a href="../{{Shareable.Url}}" target="_blank" style="text-decoration: none; background-color: #02bff6; color: #ffffff; border-top: 10px solid #02bff6; border-right: 20px solid #02bff6; border-bottom: 10px solid #02bff6; border-left: 20px solid #02bff6;display: inline-block;" class="shareable-button">View {{Shareable.ShareableTypeLowercase}}</a>
                        </td>
                    </tr>
                </table>

            </td>
        </tr>


        <tr>
            <td bgcolor="#f4f4f4" align="center" style="padding: 0px 10px 0px 10px;">

                <table border="0" cellpadding="0" cellspacing="0" width="100%" style="max-width: 600px;">

                    <tr>
                        <td bgcolor="#f4f4f4" align="left" style="padding: 20px 30px 30px 30px; color: #666666; font-family: 'Lato', Helvetica, Arial, sans-serif; font-size: 13px; font-weight: 400; line-height: 16px;">
                            <p style="margin: 0;">Powered by Apteco Ltd
                        </td>
                    </tr>
                </table>

            </td>
        </tr>
    </table>

</body>
</html>
```
