End user attributes synced from your Identity Provider (IdP) through End User Management can be referenced as dynamic variables in Device Settings, Custom Profiles, and Managed App Configurations. Use the syntax {{.User "field_id"}} replacing field_id with any attribute ID from the reference table below to automatically populate profile fields with user-specific values. This feature requires End User Management to be configured and a user assigned to the device.
How It Works
When an MDM payload or Managed App Configuration is deployed to a device, Addigy replaces each {{.User "field_id"}} variable with the actual value from the assigned end user's profile. For example, {{.User "user_name"}} is replaced with the user's primary email address at deployment time.
If no user is assigned to the device, or if the referenced field is empty, the variable resolves to an empty string.
Syntax
Format:
{{.User "field_id"}}
Example:
{{.User "emails_primary"}}
This resolves to the assigned user's primary email address (e.g., jsmith@company.com).
Available Fields
The table below lists every end user attribute that can be used as a variable in Device Settings, Custom Profiles, and Managed App Configurations.
Note: Fields marked as list may return multiple values. Use the specific sub-fields (e.g., emails_primary instead of emails) to ensure a single value is returned.
Identity
Field ID
Display Name
Type
id
ID
string
external_id
External ID
string
user_name
Username
string
display_name
Display Name
string
nick_name
Nickname
string
title
Title
string
user_type
User Type
string
Localization
Field ID
Display Name
Type
preferred_language
Preferred Language
string
locale
Locale
string
timezone
Time Zone
string
Status
Field ID
Display Name
Type
active
Active
boolean
Name
Field ID
Display Name
Type
name_formatted
Full Name
string
name_family_name
Last Name
string
name_given_name
First Name
string
name_middle_name
Middle Name
string
name_honorific_prefix
Name Prefix
string
name_honorific_suffix
Name Suffix
string
Emails
Field ID
Display Name
Type
emails
Emails
list
emails_primary
Primary Email
string
emails_work
Work Email
string
emails_home
Home Email
string
Phone Numbers
Field ID
Display Name
Type
phone_numbers
Phone Numbers
list
phone_numbers_primary
Primary Phone Number
string
phone_numbers_work
Work Phone Number
string
phone_numbers_mobile
Mobile Phone Number
string
phone_numbers_home
Home Phone Number
string
Addresses
Field ID
Display Name
Type
addresses_formatted
Addresses
list
Primary Address
Field ID
Display Name
Type
primary_address_formatted
Primary Address
string
primary_address_street_address
Primary Street Address
string
primary_address_locality
Primary City
string
primary_address_region
Primary State/Region
string
primary_address_postal_code
Primary Postal Code
string
primary_address_country
Primary Country
string
Work Address
Field ID
Display Name
Type
work_address_formatted
Work Address
string
work_address_street_address
Work Street Address
string
work_address_locality
Work City
string
work_address_region
Work State/Region
string
work_address_postal_code
Work Postal Code
string
work_address_country
Work Country
string
Home Address
Field ID
Display Name
Type
home_address_formatted
Home Address
string
home_address_street_address
Home Street Address
string
home_address_locality
Home City
string
home_address_region
Home State/Region
string
home_address_postal_code
Home Postal Code
string
home_address_country
Home Country
string
Instant Messaging
Field ID
Display Name
Type
ims
Instant Messaging IDs
list
ims_primary
Primary IM
string
Groups, Roles & Entitlements
Field ID
Display Name
Type
groups
Groups
list
roles
Roles
list
roles_primary
Primary Role
string
entitlements
Entitlements
list
entitlements_primary
Primary Entitlement
string
Metadata
Field ID
Display Name
Type
meta_created
Created At
date
meta_last_modified
Last Modified At
date
Enterprise
Field ID
Display Name
Type
enterprise_employee_number
Employee Number
string
enterprise_cost_center
Cost Center
string
enterprise_organization
Organization
string
enterprise_division
Division
string
enterprise_department
Department
string
enterprise_manager_id
Manager ID
string
enterprise_manager_name
Manager Name
string
Connection
Field ID
Display Name
Type
tenant_connection_id
Connection ID
string
Examples
Auto-populating a user's email in a Wi-Fi payload
Use {{.User "emails_primary"}} in the UserName field of a Wi-Fi payload to automatically fill in the assigned user's email address:
This resolves to the user's full name as synced from your IdP (e.g., Jane Smith).
Notes
Variables are resolved at the time the payload or managed app config is deployed to the device. If a user's attributes change after deployment, the payload or app config will need to be redeployed to reflect the updated values.
If the end user attribute is empty or no user is assigned to the device, the variable resolves to an empty string.
End User Management must be configured before variables can be used. See End User Management for setup instructions.