Category Filter
 
 

Last updated: August 13, 2026

iOS Apps Configurations

This page explains Managed App Configuration (App Config), an iOS and macOS feature that enables MDM to automatically push predefined settings directly to managed apps via XML plist schemas defined by app developers. IT admins will learn why App Config ensures fleet-wide standardization and zero-touch deployment, when developer involvement is required, how to use dynamic variables such as %email% and %username% in configuration payloads, and the step-by-step process for uploading app configurations through the MDM console.

Managed App Configuration (often called "App Config") is a feature of iOS and macOS that allows MDM to push specific settings and preferences directly to a managed application. Instead of requiring users or IT admins to configure an app after installation manually, these settings are automatically applied upon app installation or update. The mechanism relies on a predefined schema, typically a property list (plist) in XML format, that is created by the app's developer. This schema defines the configurable keys. The MDM server pushes these key-value pairs to the device, and the iOS system delivers them to the designated app.

Why is Managed App Configuration Valuable?

  • Standardization: Ensures every instance of an app across your fleet is configured identically according to corporate policy.
  • Zero-Touch Deployment: Apps are installed and configured automatically, providing a seamless out-of-the-box experience for the end-user.
  • Enhanced Security: Allows admins to enforce security policies within apps, such as forcing encrypted connections, disabling backups of sensitive data, or pre-configuring compliance settings.

How App Config works?

  • To Define Keys: The app developer must define the specific keys (e.g., serverURL, enableAutoUpdate, companyTenantID) that their app will accept.
  • To Handle the Payload: The app's code must include logic to check for a Managed App Configuration payload upon launch and apply the provided key-value pairs to its internal settings.
  • To Provide the Schema: Developers should provide documentation or a sample XML plist detailing all supported keys, their expected data types (string, integer, boolean, etc.), and possible values.

As an Admin, your role is to:

  1. Obtain the configuration schema from the developer or vendor.
  2. Format these keys and values into a valid XML plist.
  3. Upload and assign this configuration within your MDM console.

How to Implement Managed App Configuration?

Pre-requisites: The app developer must support app configurations for the app, to implement it using MDM.

Process for MDM Admins:

  1. On the MDM console navigate to Device Mgmt > App Repository.
  2. Either select an existing app from your repository or add a new one (e.g., from the App Store or as a custom internal app).
  3. For a new app, you will find a Configurations section during the setup process. 
    For an existing app, click the ellipsis (...) button under Action and select Modify App.
  4. To avoid creating static configurations for each user, MDM support dynamic variables in your XML values. These variables are automatically replaced with device-specific or user-specific information from the enrollment record. 
    Example: Instead of hard-coding john.doe@zylker.com, use %email%. The MDM will populate the user's actual email address upon deployment.

    Here is the table of parameters for which MDM supports dynamic variables:

    PARAMETERDYNAMIC VARIABLE
    Device UDID%udid%
    Device Name%devicename%
    User Name%username%
    E-mail%email%
    Domain name%domainname%
    Serial Number%serialnumber%
    IMEI%imei%
    Exchange ID%easid%

    Sample XML file 
    The app configuration file is an XML file which contains details regarding the configurations supported by the app. A sample XML file is shown below:

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
    <plist version="1.0">
    <dict>
                 <key>serverURL</key>
                <string>myServerUrl.myDomain.com</string>
                <key>username</key>
                <string>%username%</string>
                <key>domain</key>
                <string>%domainname%</string>
                <key>email</key>
                <string>%email%</string>        
    </dict>
    </plist>
  5. Save the changes to the app configuration in the MDM. The configuration will be pushed to the devices immediately. When the app is distributed to new devices, the app configuration will also be sent along.
    To meet your organizational needs, you can create app configurations for the following applications.

Frequently asked questions

What is Managed App Configuration (App Config) for iOS and macOS apps?

Managed App Configuration, or App Config, is an iOS and macOS feature that lets MDM push predefined settings and preferences directly to a managed app based on a schema the app developer defines, so the app is configured automatically on installation or update instead of requiring manual setup.

Does the app developer need to do anything for App Config to work?

Yes. The developer must define the configurable keys the app accepts, add logic in the app to read the Managed App Configuration payload on launch, and provide documentation or a sample XML plist describing the supported keys and their data types.

Can app configuration values be personalized per user or device?

Yes. MDM supports dynamic variables such as %email%, %username%, %udid%, %devicename%, %domainname%, %serialnumber%, %imei%, and %easid% in your XML values, which are automatically replaced with the actual device- or user-specific values from the enrollment record during deployment.

How do I add a Managed App Configuration to an app in MDM?

On the MDM console, go to Device Mgmt > App Repository, then either configure the app during setup (for a new app) or click the ellipsis under Action and select Modify App (for an existing app), and upload the XML plist containing the configuration keys and values.

Which apps can I configure using Managed App Configuration in MDM?

MDM supports Managed App Configuration for apps including Microsoft Outlook, IBM Verse, Mattermost, Zoho Mail, and Imprivata Cortext, provided the app developer supports app configurations.

Jump To