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:

VariableDescriptionExample
{{name}}User’s display nameJohn Smith
{{givenName}}First nameJohn
{{surname}}Last nameSmith
{{mail}}Primary email addressjohn.smith@company.com
{{jobTitle}}Job titleSenior Developer
{{department}}Department nameEngineering
{{officeLocation}}Office locationBuilding A, Floor 3
{{city}}CitySan Francisco
{{state}}State or provinceCalifornia
{{country}}CountryUnited States
{{postalCode}}Postal/ZIP code94105
{{streetAddress}}Street address123 Main Street

Contact Variables

VariableDescriptionExample
{{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:

VariableDescriptionSource
{{companyName}}Company nameOrganization settings or user profile

Extention Attribute Variables

These variables can be populated from Microsoft Entra ID extension attributes:

VariableDescription
{{extensionAttribute1}}Customizable variable from Microsoft Entra ID
{{extensionAttribute...}}Avaialble from 1 to 15
{{extensionAttribute15}}Customizable variable from Microsoft Entra ID

Custom Variables

Custom variables you create are prefixed with custom_:

VariableDescription
{{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:

  1. Click the Variable button in the toolbar
  2. Browse available variables by category
  3. Click a variable to insert it at your cursor position
  4. 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:

  1. Go to Settings → Microsoft 365 Setup
  2. Click Sync Users Now

Was this article helpful?

ON THIS PAGE


Need help?

Contact Support