title: Email Template Variables Reference category: Email Templates tags: email, templates, variables, conditional, loops, reference priority: Normal

Email Template Variables Reference

This is the complete reference for all template variables available in IdentityCenter email templates. Variables allow you to insert dynamic, context-specific content into your email notifications.

Variable Syntax

Variables use double curly brace notation:

{{VariableName}}

Variables are replaced with actual values when the email is rendered. If a variable has no value, it renders as an empty string.

User Variables

These variables provide information about the person associated with the notification (the subject of the action, not necessarily the recipient):

Example usage:

<p>Hello {{FirstName}},</p>
<p>This notification is regarding account <strong>{{UserName}}</strong>
in the {{Department}} department.</p>
<p>Your manager, {{Manager}}, has been copied on this notification.</p>

Object Variables

These variables provide information about directory objects involved in the notification:

Example usage:

<p>The following directory object requires attention:</p>
<table>
  <tr><td><strong>Object:</strong></td><td>{{ObjectCN}}</td></tr>
  <tr><td><strong>Type:</strong></td><td>{{ObjectType}}</td></tr>
  <tr><td><strong>Status:</strong></td><td>{{AccountStatus}}</td></tr>
  <tr><td><strong>Last Logon:</strong></td><td>{{LastLogon}}</td></tr>
  <tr><td><strong>Location:</strong></td><td>{{ObjectOU}}</td></tr>
</table>

Policy Variables

These variables are available in policy violation notifications:

Example usage:

<div class="severity-{{ViolationSeverity}}">
  <h3>Policy Violation: {{PolicyName}}</h3>
  <p>{{ViolationDescription}}</p>
  <p><strong>Recommended Action:</strong> {{RemediationAction}}</p>
  <p><strong>Detected:</strong> {{ViolationDate}}</p>
</div>

Workflow Variables

These variables are available in workflow and approval notifications:

Example usage:

<p>Hello {{ApproverName}},</p>
<p>A new {{RequestType}} requires your approval:</p>
<ul>
  <li><strong>Requested by:</strong> {{RequestorName}}</li>
  <li><strong>Details:</strong> {{RequestDetails}}</li>
  <li><strong>Due by:</strong> {{DueDate}} ({{DaysRemaining}} days remaining)</li>
</ul>
<p><a href="{{ApprovalLink}}" class="button">Review Request</a></p>

System Variables

These variables provide general system information:

Example usage (email footer):

<div class="footer">
  <p>This is an automated message from {{SystemName}}.</p>
  <p>If you have questions, contact <a href="mailto:{{SupportEmail}}">{{SupportEmail}}</a>.</p>
  <p>&copy; {{CurrentYear}} {{CompanyName}}. All rights reserved.</p>
</div>

Conditional Content

Use conditional blocks to show or hide content based on variable values.

Basic If/Else

{{#if ViolationSeverity == "Critical"}}
<div style="background: #dc3545; color: white; padding: 10px;">
  <strong>CRITICAL:</strong> Immediate action required!
</div>
{{/if}}

{{#if DaysRemaining <= 3}}
<p style="color: red;">This request is due in {{DaysRemaining}} days.</p>
{{else}}
<p>This request is due on {{DueDate}}.</p>
{{/if}}

Checking for Empty Values

{{#if ManagerEmail}}
<p>Your manager ({{Manager}}) has been notified.</p>
{{else}}
<p>No manager is assigned to your account. Please contact IT.</p>
{{/if}}

Nested Conditions

{{#if ViolationSeverity == "Critical"}}
  <p style="color: red;">Immediate action required within 24 hours.</p>
{{else}}
  {{#if ViolationSeverity == "High"}}
    <p style="color: orange;">Please address within 3 business days.</p>
  {{else}}
    <p>Please review at your earliest convenience.</p>
  {{/if}}
{{/if}}

Loops

Use loops to iterate over collections and display lists of items.

Basic Loop

<h3>Affected Users:</h3>
<table>
  <tr><th>Name</th><th>Account</th><th>Status</th></tr>
  {{#each AffectedUsers}}
  <tr>
    <td>{{this.DisplayName}}</td>
    <td>{{this.UserName}}</td>
    <td>{{this.AccountStatus}}</td>
  </tr>
  {{/each}}
</table>

Loop with Conditional

<h3>Pending Review Items:</h3>
<ul>
{{#each PendingItems}}
  <li>
    {{this.UserName}} - {{this.AccessDescription}}
    {{#if this.IsHighRisk}}
      <span style="color: red;">[HIGH RISK]</span>
    {{/if}}
  </li>
{{/each}}
</ul>

Loop with Index

<ol>
{{#each Steps}}
  <li>{{this.Description}} — {{this.Status}}</li>
{{/each}}
</ol>

Testing Templates

Preview with Sample Data

The email template editor at Administration > Email Templates (EmailTemplates.razor) includes a preview function:

1. Open the template you want to test
2. Click Preview
3. Select a sample data source (real or synthetic data)
4. Review how variables are rendered in both desktop and mobile views
5. Check that conditional blocks display correctly for different scenarios

Test Scenarios to Verify

Send a Test Email

1. After previewing, click Send Test
2. Enter a recipient email address
3. Select the sample data source
4. Check the received email in your inbox for formatting, links, and variable replacement

Creating New Templates vs. Editing Defaults

Best practice: Clone the default template before editing so you can always revert to the original.

HTML Formatting Tips

1. Use inline styles -- Many email clients strip <style> blocks. Inline CSS is the most reliable approach.
2. Use tables for layout -- Flexbox and CSS Grid are not supported in all email clients.
3. Keep width under 600px -- Standard email viewport width.
4. Test in multiple clients -- Outlook, Gmail, Apple Mail, and mobile clients all render differently.
5. Provide alt text for images -- Some clients block images by default.

Next Steps

• Email Configuration
• Creating Email Templates
• Troubleshooting Email Delivery
• User & Role Management