A managed configuration allows users to apply additional settings to supported iOS and iPadOS applications. In addition, users can apply dynamic placeholders, also known as custom attributes or key value pairs, to expose specific device information. For example, these configurations can be used to identify devices out in the field with their console counterparts and to link devices with certain locations via their aliases or other unique identifiers.
Dynamic placeholders are also available for Android applications.
In this article:
Supported Dynamic Placeholders
The following dynamic placeholders are supported on iOS and iPadOS devices. You may need to discuss with your app developer about the values supported by your application. Values do not update automatically. If a value is updated, a new converge or install command will need to be fired.
| Placeholder | Description | Example Value |
| ${esper.id} | Esper device identifier | 555e8400-e29b-41d4-a716-446655440000 |
| ${esper.tenantId} | Tenant identifier | 123e4567-e89b-12d3-a456-426614174000 |
| ${esper.name} | Esper Device name | iPad-Office-001 |
| ${esper.alias} | Device alias | Reception-iPad |
| ${esper.serialNumber} | Device serial number | DMQVGC0DHHL0 |
| ${esper.udid} | Unique Device Identifier | 00008020-001C2D8E2E20002E |
| ${esper.model} | Device Model | iPhone 13 |
| ${esper.osVersion} | Device Current OS Version | 26.0 |
Example Usage
The input configuration is a Property List (Plist) of keys and values wrapped in a dictionary tag.
Example Input
<dict>
<key>DEVICE_SERIAL</key>
<string>${esper.serialNumber}</string>
<key>DEVICE_NAME</key>
<string>${esper.name}</string>
<key>TENANT_ID</key>
<string>${esper.tenantId}</string>
</dict>Example Output
<dict>
<key>DEVICE_SERIAL</key>
<string>DMQVGC0DHHL0</string>
<key>DEVICE_NAME</key>
<string>iPad-Office-001</string>
<key>TENANT_ID</key>
<string>123e4567-e89b-12d3-a456-426614174000</string>
</dict>
Applying a Managed Configuration
In a blueprint, go to the Apps & Configuration section and click on the iOS tab.
In Manage Applications, add a new application or identify an existing one that supports managed configurations. Then click on the ellipsis button next to the application and select Managed Configuration.
Then paste the configuration in the input box.
Click on Apply Changes.
Then save and publish the blueprint.
When you converge a device to that blueprint, the managed configuration will be applied to the application currently on the device or will be installed with the application.
Remember to converge the device to update these values. Use dynamic placeholders with managed configurations to unlock further customization for your iOS fleet.
Learn more about iOS Managed Configurations.