How-tos

3 mins read

Customizing Cloudentity Messages - Activation, Password Reset, OTP and More

This article describes how to customize messages that are being sent to users during different flows. You can modify email base template, particular email content, or resign from our structure and build every email separately from scratch. You can also modify any text message content.

Prerequisite

Customize Email Messages

Below, you can see the default email that is sent to users during self registration to Identity Pool. You can:

We will modify the email base template by adding a Social Media Panel with links and Social Media Images to all email messages, and adjust the text of an individual email message.

Default email for self activation with code

Brand Email Base Template

Modifying Email Base Template results in changing the appearance of all email messages. You can either make just small adjustments or build your own emails from scratch!

In this section, we will add a new part to the email footer - a social tab with some Social Media logos and links to company’s channels.

  1. Select Components » base_email.tmpl in your theme HTML editor.

    You can now modify the email base template. Note that for base templates there is no preview - if you wish to see your changes, save the template and, in the Messages tab, select any of the emails.

  2. Find the div of the footer-logo class and insert the below code beneath it.

    <div class="caption footer-caption">
       FIND US ON:
    </div>
    <div class="caption">
       <a href="https://twitter.com/CloudentityTEAM">
          <img class="footer-image" src="https://www.svgrepo.com/show/416494/connect-media-networking.svg">
       </a>
       <a href="https://github.com/cloudentity">
          <img class="footer-image" src="https://www.svgrepo.com/show/416517/code-github-hosting.svg">
       </a>
    </div>
    
  3. Add styling for our social panel as part of the <style> element.

    See example:

    <style type="text/css">
       [...]
    
       .footer-image {
         max-height: 32px;
         margin: 5px;
       }
    
       [...]
    </style>
    
  4. Select Save, go to the Messages tab, and select an email of your choice from the list, for example, the Activate Account With Code message template.

  5. Preview your changes to the template.

    Branded Email - Social Tab added

    You can check other email message templates and you will see that now all emails have the Social Media panel added.

  6. Bind the theme to a workspace if not yet bound.

To view your changes in action, you can now, for example, register a user in Identity Pools and an email will be automatically sent to the user requesting account activation.

Modify Email Message

  1. In your theme HTML editor, navigate to Messages tab and select an email template from the dropdown.

    For the illustration purposes, we will modify the text content of the Acctivate Account with Code template.

  2. Modify the HTML code of the email message template according to your needs.

    For example, let’s modify the text of the template. By default, before providing the account activation code, the message has the following HTML content:

    <div class="main-text">Just one more step to access it</div>
    

    Let’s change it to:

    <div class="main-text">Here is your account activation code!</div>
    
  3. Save changes.

  4. Bind the theme to a workspace if not yet bound.

To view your changes in action, you can now, for example, register a user in Identity Pools and an email will be automatically sent to the user requesting account activation.

Customize Text Messages

Since text messages are rather simple by design, by default, text messages do not use any base template unlike email messages - but they can, if needed. See example text message below:

Text message customization

To edit text message contents:

  1. In your theme HTML editor, select the Messages tab and choose the SMS message template you wish to edit.

  2. Edit the template and select Save.

  3. Bind the theme to a workspace if not yet bound.

Updated: May 23, 2023