how tos

Customize Email Templates

Express lets you to design custom emails triggered by user account activity.

For example, you can set up an account verification email that’s sent when a user registers for your service or application. That same email can also welcome users to your service.

ForgeRock email templates work with Markdown, based on the CommonMark specification, and enhanced by the markdown-it parser. You can test options on the markdown-it demo site. You can also:

  • Use variables to help personalize messages.
  • Skin templates using CSS.

To use the Express console: Click Email > Templates.

alt text

To use the Express REST APIs: In the Express Postman Collection,
go to Management APIs > Email Templates.

alt text

Available Templates

You can use the console to configure the following email templates:

Template Name Description Status
Registration When a user registers on your service or application
This email is sent if requireEmailVerification is set to true in Password Policy
Always Enabled
Welcome When users verify their email addresses Disabled
Forgotten Password Whenever a user requests a password change Always Enabled
Password Updated Confirms a recent password change Enabled
Updated Email Address Sent after a user changes the account email address Disabled
Username Recovery For users who need help recovering their usernames Always Enabled
Username Recovery Confirmation After a user has recovered their username Disabled
Verification Code (1) An option for 2FA Always Enabled


  • If a template is Always Enabled, you’re not allowed to disable it at the Express console.
  • The Verification Code (1) template applies only when email is configured as the second factor in two-factor authentication.


You can add variables to the template. Use double curly braces:

{{ variableName }}

The variables will then pull data from entities such as users,

apps, and tenants. The following table includes example variables:

Variable Description Example
{{}} Name of application. TrakMyExpenses
{{user.emails.primary}} Primary email of the user. [email protected]
{{user.preferredLanguage}} Preferred language of the user. en-US
{{}} Given name / first name of the user. Barbara
{{}} Family name / last name of the user. Jensen
{{}} User’s fully formatted name. Ms. Barbara J Jensen, III
{{user.displayName}} User’s display name. Babs Jensen
{{user.userName}} The username. bjensen
{{url}} Generic link for account activity such as registration password reset.  
{{url.expiry}} Limit on URL validity, in hours.  
{{date}} Date and time of request in ISO 8601 format.  
{{}} Organization name. Mega Money Mgr Inc.
{{}} Tenant Name. Mega Money Mgr-Dev

For questions or feedback, contact us.