Skip to content

Customize email templates

The following topics explain how you can customize email notifications that are sent to users of your WSO2 Identity Server organization.

Customize email branding

Once you publish your branding preferences on WSO2 Identity Server, the branding preferences are automatically applied to emails sent to the users of your organization.

The branding variables that affect the email templates are as follows:

Email branding for B2B applications

If you have organizations configured, note that the email branding you configure for your organization (root) also applies to your organizations.

Branding email templates

Template variable Branding preference
1 Organization Logo Design > Theme Preferences > Images > Logo URL
Logo alternative text Design > Theme Preferences > Images > Logo Alt Text
2 Primary color Design > Theme Preferences > Color Palette > Primary Color
3 Email background color Design > Theme Preferences > Color Palette > Body Background > Main Background Color
4 Email body color Design > Theme Preferences > Color Palette > Surface Background > Main Surface Background Color
5 Email font Design > Theme Preferences > Font > Font Family
6 Email body font color Design > Theme Preferences > Color Palette > Text Colors > Primary Text Color
7 Email button font color Design > Theme Preferences > Buttons > Primary Button > Font Color
8 Copyright text General > Copyright Text
9 Support email General > Contact Email

Customize email content

You can tailor the subject, body, and footer of email notifications to your preferences by following the steps below.


This feature is only available for the most frequently used email templates. You can customize all available email templates using the Email Templates API.

  1. On the WSO2 Identity Server, go to Branding > Email Templates.
  2. Select the email template and the relevant locale that you wish to modify.


    Asgardeo gives you the option to automatically copy a template from one locale to another so that you do not have to create email templates from scratch. To do so, select a locale with an existing email template, switch over to the new locale and click confirm when the Replicate content? prompt appears.

    Select email template

  3. Make your modifications in the Content tab and use the Preview tab for a real-time preview.

  4. Click Save to publish your changes.

Apply changes to user profiles

To apply these changes to each user's profile in your organization:

  1. Display the local attribute on the user's profile. Learn more on updating user attributes.

  2. Update the local attribute value with the required locale code.

    • If the admin onboards the user to the organization, the admin is responsible for updating the locale code.

    • If the user self-registers, they should update the locale code by themselves at the time of registration.

Alternatively, you can customize the content of email templates using the Email Templates API provided by WSO2 Identity Server.