This documentation is for WSO2 Identity Server 5.3.0 . View documentation for the latest release.

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Reverted from v. 16

The WSO2 Identity Server (WSO2 IS) provides the means of customizing automated emails sent to the user. This is particularly useful in the case of tenant users as they can customize their emails specifically for users configured under the tenant. Furthermore, tenants do not have access to underlying configuration files, therefore, this customization is now possible directly through the management console.

...

Table of Contents

Adding an email template type

  1. Log in to the WSO2 Identity Server management console.
  2. Navigate to the Main tab and click Add under Email Templates, which is available under the Manage section.
  3. Click Add Email Template Type.
  4. Enter the name that you want to be displayed for the new email template type in the Template Type Display Name.
  5. Click Add.

Adding an email template

This allows you to add a new email template for a specific email template type and language. As a result, there may be multiple email for a specific email template type based on the language of the email template.

  1. Log in to the WSO2 Identity Server management console.
  2. Navigate to the Main tab and click List Add under Email Templates, which is available under the Manage section.
  3. ClickAdd Email Template.
  4. Select the Template Type, Template Language (locale) and Content Type.

    Update the template contents (i.e., Subject, Email Body and Email Footer).

    /enter the email template details.

    Multiexcerpt include
    MultiExcerptNameemailTemplatePara
    PageWithExcerptEmail Templates

    Image Added


    Multiexcerpt
    MultiExcerptNamespecial
    Tip
    titlePlaceholders and Custom Claim Dialects

    Tip: You can set different placeholders in order to populate custom information such as {first-name} and {user-id} in the subject, body and footer of the email template.

    You can also specify any custom claim URI created in the WSO2 claim dialect:

    • If it an identity claim, specify the claim as seen in the example below.

      Panel
      bgColorWhite

      The claim http://wso2.org/claims/identity/homeAddress should be specified as {{user.claim.identity.homeAddress}}

    • If it is a normal claim, specify the claim as seen in the example below.

      Panel
      bgColorWhite

      The claim http://wso2.org/claims/homeAddress should be specified as{{user.claim.homeAddress}}.

    Before sending the email, the WSO2 IS will retrieve the user details from the user store configured for this tenant and replace the placeholders with the corresponding values of the user.

  5. Click Add to add a new email template.

Deleting an email template type

Warning

This deletes all the email templates that correspond to the selected email template type together with the email template type.

  1. Log in to the WSO2 Identity Server management console.
  2. Navigate to the Main tab and click List under Email Templates, which is available under the Manage section.
  3. Select the email template type.
  4. Click Delete Template Type and click ok.

Editing an email template

  1. Log in to the WSO2 Identity Server management console.
  2. Navigate to the Main tab and click List under Email Templates, which is available under the Manage section.
  3. Select/enter the email template details based on the fields that you want to update in the email template.

    Multiexcerpt include
    MultiExcerptNameemailTemplatePara
    PageWithExcerptEmail Templates

    Tip
    titlePlaceholders and Custom Claim Dialects

    Tip: You can set different placeholders in order to populate custom information such as {first-name} and {user-id} in the subject, body and footer of the email template.

    You can also specify any custom claim URI created in the WSO2 claim dialect:

    • If it an identity claim, specify the claim as seen in the example below.

      Panel
      bgColorWhite

      The claim http://wso2.org/claims/identity/homeAddress should be specified as {{user.claim.identity.homeAddress}}

    • If it is a normal claim, specify the claim as seen in the example below.

      Panel
      bgColorWhite

      The claim http://wso2.org/claims/homeAddress should be specified as{{user.claim.homeAddress}}.

    Before sending the email, the WSO2 IS will retrieve the user details from the user store configured for this tenant and replace the placeholders with the corresponding values of the user.

  4. Click Save to update.

...

Deleting an email template

Using the following steps you can delete a specific email template that corresponds to an email template type.

  1. Log in to the WSO2 Identity Server management console.
  2. Navigate to the Main tab and click List under Email Templates, which is available under the Manage section.
  3. Select the email template type and the respective email template.
  4. Click Delete Template and click ok.

Updating the locale of a user

...

Now that this is done, any email notifications you receive will be in the language you specified.

...

titleRelated Links

...

For details on how to customize the automated emails, see Customizing Automated Emails.

...

.