Rebranding Emails
  • 18 May 2022
  • 9 Minutes to read
  • Contributors
  • Dark
    Light
  • PDF

Rebranding Emails

  • Dark
    Light
  • PDF

Sisense automated emails are sent to users according to predefined scenarios. When a predefined scenario such as a build alert is triggered, an automated email is sent to the relevant Sisense users.

You can customize these emails to match your company’s branding.

The process for white labeling your emails is to create your own custom emails, overwrite the current Sisense emails, and then configure Sisense to use your custom branding through the Configuration Manager or REST API.

Sisense Automated Emails

You can white label the following automatic emails:

Build Alert: Sent each time a build alert is triggered.

  • Dashboard Errors Reports: Sent when a dashboard report fails.
  • Dashboard Errors Reports Bulk Fail: Sent when a large amount of email reports fail.
  • Dashboard Reports: Sent to the recipient of a shared dashboard when you share a dashboard.
  • Empty Dashboard Report: Sent to an Administrator when an empty dashboard report is sent.
  • KPI Alert: Sent each time a KPI alert is triggered.
  • New User Invitation: Sent to a new user invited to Sisense .
  • Password Recovery: Sent to a user who requested a new password.
  • Share ElastiCube : Sent to the recipient of a shared ElastiCube .
  • Share With: Sent to the recipient of a shared dashboard.
  • Transfer Ownership: Sent to a user who received ownership of a dashboard from another owner.
  • User Created: Sent to a user when a user is created.
  • User Created AD: Sent when a user is created in Sisense after being added from Active Directory.

For each automated email, Sisense provides an email template in the format in LESS and EJS formats, located at:

/opt/sisense/storage/branding/{your brand}/emails

OR

In the /emails directory of the File Manager:
white labelling two

For information about accessing the File Manager, see Uploading Files to Customize Your Linux Deployment.

LESS Files

All templates contain the style.less file that refers to a stylesheet that defines the branding used in Sisense’s automated emails, located at:

/opt/sisense/storage/emails

By replacing the content of the styles.less file with your own CSS, you can redefine the branding used in all of the email templates to your custom branding.

EJS Files

Each template folder contains an EJS file, which contains HTML and JavaScript that describe the content of the email.

You can use any text/HTML editor to modify the HTML.ejs files according to your needs.

The following is an example of an HTML.ejs file.

<% include ../header %>
<tr>
<td>
<div class="contentText">
<p class="userText" style="margin: 0;"><%= i18nContent.hi %> <%= newOwnerUserName %>,</p>
<p class="generalInfo" style="margin: 0;"><%- i18nContent.generalInfo %></p>
</div>
</td>
</tr>
<% include ../footer %>

white labelling two 2

Each EJS file has three sections, a header, body, and footer; each of which describes various areas in the email your users receive.

Section 1 is the Header section defined in the EJS file as <% include ../header %>.

The header.ejs file defines the title and image used in the header section of each email template. You can modify the header by replacing the header.ejs file or by replacing the <% include ../header %> tag from each template with your own HTML and JavaScript.

Section 2 is the Body section, which contains the content displayed in the email your users receive. There are two types of content displayed in automated emails: tokens and strings. Tokens refer to Sisense variables, such as the Sisense username or dashboard owner’s name. For example, the <%= newOwnerUserName %> token displays the new owner of a dashboard’s Sisense username in the automated email.

<tr>
<td>
<div class="contentText">
<p class="userText" style="margin: 0;"><%= i18nContent.hi %> <%= newOwnerUserName %>,</p>
<p class="generalInfo" style="margin: 0;"><%- i18nContent.generalInfo %></p>
</div>
</td>
</tr>

When you replace the HTML.ejs file with your own files, you can still use the Sisense tokens. For more information about tokens you can add to your automated emails, see Applying Sisense Tokens.

In addition, each template contains an object such as i18nContent.hi that displays strings predefined by Sisense. These strings can't be modified. However, you can remove and replace the object with your own content.

Section 3 contains the footer. The footer, <% include ../footer %> , is a reference to a footer.ejs file located at:

/opt/sisense/storage/emails

OR

/emails in the File Manager.

The footer.ejs file defines the copyright text and image used in the footer section of each email template. You can modify the footer by replacing the footer.ejs file with or replace the <% include ../footer %> tag from each template with your own HTML and JavaScript.

Images displayed in the Header and Footer are stored in the following location:

/opt/sisense/storage/emails/images

OR

/emails/images/ in the File Manager.

You can replace these with your own images by maintaining the same file names used. However, it is recommended to replace the content of the Header and Footer sections together with your own content.

Applying Sisense Tokens

Most Sisense automated emails include tokens that you can apply to your automated emails. When the email is sent, Sisense populates the token with the relevant value. For example, the <%= owner %> token represents the owner of the dashboard.

Each template has tokens defined by Sisense for each automated email that you can apply listed below. Tokens from one automated email can't be applied to another.

build_alert: Sent when a build alert is triggered.

No Template Tokens Available

Dashboard_errors_report: Sent when an Dashboard email report fails.

Template Tokens Available

<%= errors[i].error %>
<%= errors[i].widgetFailed %>
<%= errors[i].widgetCount %>

Dashboard_errors_report_bulk_fail: Sent when a Dashboard email report sent to a large number of users fails.

Template Tokens Available

<%= errors.groups[i] %>

Dashboard_report: An automated email that contains a dashboard report sent to users.

Template Tokens Available

<%= url %>
<%= images[i] %>

Empty_dashboard_report: An automated email that contains an empty dashboard report sent to users.

No Template Tokens Available

Kpi_alert: Sent to shared users when a KPI alert is triggered.

Template Tokens Available

<%= measure %>
<%= value %>
<%= message %>

New_user_invitation: Sent to a new user that you have invited to join.

Template Tokens Available

<%= owner %>

*The folder for this template contains a file called HTML-ORG.ejs. This file is for older versions of Sisense and is maintained for backward compatibility.

Password_recovery: Sent when a user requests their password from the Forgot Password page.

No Template Tokens Available

  • The folder for this template contains a file called HTML-ORG.ejs. This file is for older versions of Sisense and is maintained for backward compatibility.

Share_with: Sent to a new recipient of a dashboard when the dashboard is shared with them.

No Template Tokens Available

  • The folder for this template contains a file called HTML-ORG.ejs. This file is for older versions of Sisense and is maintained for backward compatibility.

transfer_ownership: Sent to the new owner of a dashboard when ownership is transferred.

Template Tokens Available

<%= newOwnerUserName %>
<%= oldOwnerUserName %>
<%= sharingDashboardName %>

User_created: Sent to the recipients of new Sisense accounts.

No Template Tokens Available

User_created_ad: Sent when a user is created in Sisense after being added from Active Directory.
No Template Tokens Available

Configuring Sisense Automated Emails

In addition to modifying the automated emails, there are a few changes you must make to your Sisense configuration to white lebel your Sisense emails, for example the name of the sender or the subject name. There are two ways you can modify the Sisense automated email configuration: through the UI in the Sisense Configuration Manager, or programmatically through the Sisense REST API. Both methods are described below.

Configuration Manager

To modify the Sisense automated email configuration:

  1. Open the Sisense Configuration Manager. You can access it by opening the Admin tab, and then selecting System Management > Configuration.
  2. In the Configuration Manager, open the Branding tab.
  3. Under the Branding tab, enter the following details:
    • Enable Branding: Select to enable branding.
      If you enable this option, click Save at the bottom of the page and click OK to apply the changes and restart the relevant Sisense services.
    • Emails Created User Subject: Enter the text to be displayed as the Subject Line in emails sent to new users.
    • Emails New User Invite Subject: Enter the text to be displayed as the Subject Line in invitations sent to new users.
    • Emails Password Recovery Subject: Enter the text to be displayed as the Subject Line in Password Recovery emails.
    • Emails Sender Email: Enter the name that is displayed as the Sender in Sisense automated emails.
    • Emails Sender Name: Enter the name that is displayed as the Sender in Sisense automated emails.
    • Emails Share With Existing User Subject: Enter the name that is displayed as the Sender in Sisense automated emails.
    • Emails Share With New User Subject: Enter the name that is displayed as the Sender in Sisense automated emails.
    • Emails Templates Directory: Enter the name that is displayed as the Sender in Sisense automated emails.
    • Emails Transfer Ownership: Enter the name that is displayed as the Sender in Sisense automated emails.
    • Login Subtitle: Enter the name that is displayed as the Sender in Sisense automated emails.
    • Login Title : Enter the name that is displayed as the Sender in Sisense automated emails.
    • Emails Templates Directory : The directory location of your template folders. Sisense accepts /branding/<yourbrand>/emails as a custom location for automated email templates.
    • Emails Transfer Ownership : The subject line of the dashboard transfer ownership email.
  4. Click Save.

REST API

After you have prepared your new automated emails, through the /branding endpoint of the REST API, you can configure Sisense to send the customized automated emails when the relevant event is triggered.
To modify the Sisense automated email configuration through the REST API:

  1. Copy the contents of the directory:
    /opt/sisense/storage/emails
  2. Paste all the folders into the following directory:
    /opt/sisense/storage/branding/<yourbrand>/emails
    OR
    Upload all the folders to your Sisense Server through the File Manager. See Uploading Files to Customize Your Linux Deployment for more information.

    Note:
    You will modify the templates in this folder and configure Sisense to send them instead of the original Sisense automated emails.

  3. For each template you want to modify, change the contents of html.ejs files and styles.less as described in Sisense Automated Emails.
  4. On the left-hand menu, access the Sisense REST API.
  5. In the API Documentation, select version 0.9 on the top-right of the screen.
  6. Click Post/branding to access the relevant API settings, and then click Try It Out.
  7. In version 0.9 of the REST API, click POST /branding.
    white labelling two 3
  8. In the 'email' object, define the following information:
    Note:

    If you have already rebranded your Sisense, copy the current settings through the GET /branding endpoint and paste them into the POST /branding endpoint, modifying or adding the 'emails' object. If you only modify the 'emails' object, the remaining objects and keys will revert to their default Sisense settings and will overwrite any current settings.

KeyDescription
senderEmailThe email address from which the automated email is to be sent. When you define the senderEmail value, you must verify your domain in Sisense’s Mandrill email service. Click here for more information.
senderName
Note: To change the name to be displayed as the Sender in the automated email, go to a different endpoint: POST/settings/system, and change the 'senderName' setting there. You can leave the current endpoint POST /branding as-is, without making any changes to it.
templates_directoryThe directory location of your template folders. Sisense accepts /branding/<yourbrand>/emails as a custom location for automated email templates.This directory is located on your Sisense server at/opt/sisense/storage/branding/<yourbrand>/emails
passwordRecoverySubjectThe subject line of the password recovery email.
newUserInviteSubjectThe subject line of the new user email.
createdUserSubjectThe subject line of the new user invite email.
shareWithNewUserSubjectThe subject line of the shared dashboard with a new user email.
shareWithExistingUserSubjectThe subject line of the shared dashboard email.
transferOwnershipThe subject line of the dashboard transfer ownership email.

For example:

"emails": {
"senderEmail": "sys-admin@company.com",
"senderName": -----, (change this in POST​/settings​/system endpoint )
"templates_directory": "/branding/<yourbrand>/emails",
"passwordRecoverySubject": "Recover Password",
"newUserInviteSubject": "new User Account Activation",
"shareWithNewUserSubject": "A Dashboard has been shared with you:",
"shareWithExistingUserSubject": "A Dashboard has been shared with you:"
},

9. Click Run. The next time an automated email is sent, your templates are sent instead of Sisense’s predefined emails.


Was this article helpful?