Template Variables Reference
Last updated:
•
5 min read
Complete reference of all template variables available in fixSignatures. Variables automatically populate with user data from Microsoft 365.
How Variables Work
Template variables use double curly brace syntax: {{variableName}}. When a signature is rendered, these placeholders are replaced with actual user data from Microsoft Entra ID (Microsoft Entra ID).
User Profile Variables
These variables pull data from the user’s Microsoft 365 profile:
| Variable | Description | Example |
|---|---|---|
{{name}} | User’s display name | John Smith |
{{givenName}} | First name | John |
{{surname}} | Last name | Smith |
{{mail}} | Primary email address | john.smith@company.com |
{{jobTitle}} | Job title | Senior Developer |
{{department}} | Department name | Engineering |
{{officeLocation}} | Office location | Building A, Floor 3 |
{{city}} | City | San Francisco |
{{state}} | State or province | California |
{{country}} | Country | United States |
{{postalCode}} | Postal/ZIP code | 94105 |
{{streetAddress}} | Street address | 123 Main Street |
Contact Variables
| Variable | Description | Example |
|---|---|---|
{{mobilePhone}} | Mobile phone number | +1 (555) 123-4567 |
{{businessPhones}} | Office phone number | +1 (555) 987-6543 |
{{faxNumber}} | Fax number | +1 (555) 111-2222 |
Organization Variables
These variables are set at the organization level and apply to all users:
| Variable | Description | Source |
|---|---|---|
{{companyName}} | Company name | Organization settings or user profile |
Extention Attribute Variables
These variables can be populated from Microsoft Entra ID extension attributes:
| Variable | Description |
|---|---|
{{extensionAttribute1}} | Customizable variable from Microsoft Entra ID |
| Avaialble from 1 to 15 |
| Customizable variable from Microsoft Entra ID |
Custom Variables
Custom variables you create are prefixed with custom_:
| Variable | Description |
|---|---|
{{custom_disclaimer}} | Custom variable named “disclaimer” |
{{custom_promotion}} | Custom variable named “promotion” |
{{custom_banner}} | Custom variable named “banner” |
See Using Custom Variables for more information.
Conditional Blocks
Use conditional blocks to only show content when a variable has a value:
{{#variableName}}
Content shown only if variableName has a value
{{/variableName}}
Example: Conditional Phone Number
{{#mobilePhone}}
<tr>
<td>📱 {{mobilePhone}}</td>
</tr>
{{/mobilePhone}}
This row only appears if the user has a mobile phone in their profile.
Example: Conditional LinkedIn Link
{{#linkedInUrl}}
<a href="{{linkedInUrl}}">Connect on LinkedIn</a>
{{/linkedInUrl}}
Inserting Variables
In the signature editor:
- Click the Variable button in the toolbar
- Browse available variables by category
- Click a variable to insert it at your cursor position
- Or type the variable manually:
{{variableName}}
Previewing Variables
Use the Preview as dropdown to see how variables render for different users. Toggle Show Variables to switch between seeing the raw variable names and the populated values.
Common Patterns
Name and Title Block
<strong>{{name}}</strong><br>
{{jobTitle}}<br>
{{companyName}}
Contact Information
Email: <a href="mailto:{{mail}}">{{mail}}</a><br>
{{#mobilePhone}}Mobile: <a href="tel:{{mobilePhone}}">{{mobilePhone}}</a><br>{{/mobilePhone}}
{{#businessPhones}}Office: {{businessPhones}}{{/businessPhones}}
Full Address
{{#streetAddress}}{{streetAddress}}<br>{{/streetAddress}}
{{#city}}{{city}}, {{/city}}{{#state}}{{state}} {{/state}}{{#postalCode}}{{postalCode}}{{/postalCode}}
Data Source Notes
Note: Variable data is synced from Microsoft 365 nightly. Changes to user profiles in Microsoft Entra ID may take up to 24 hours to appear in signatures.
To force an immediate sync:
- Go to Settings → Microsoft 365 Setup
- Click Sync Users Now
Was this article helpful?