<aside> <img src="/icons/light-bulb_blue.svg" alt="/icons/light-bulb_blue.svg" width="40px" />

Use one of the below methods to add the Zappl preferences configuration profile to your MDM. Once added, scope the profile to all devices you plan to deploy Zappl to.

</aside>

Mobile Config File

If your MDM supports uploading a .mobileconfig file, you can download the below .mobileconfig file and upload it to your MDM to configure by using the Configuring Custom Preferences.

Zappl - Preferences.mobileconfig

Custom XML Template

Alternatively, if your MDM supports creating a custom configuration profile by adding XML, you can copy and paste the XML template below into a new profile. Configure any settings you wish to keep and remove those you don't need.

<aside> <img src="/icons/light-bulb_blue.svg" alt="/icons/light-bulb_blue.svg" width="40px" />

You can determine which preferences you require and which you may not by using ****the Configuring Custom Preferences which outlines the purpose of each preference.

</aside>

<aside> <img src="/icons/info-alternate_blue.svg" alt="/icons/info-alternate_blue.svg" width="40px" />

MDMs such as Microsoft Endpoint Manager (Intune) and Kandji support this method.

</aside>

<?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>GeneralOptions</key>
    <dict>
      <key>activationToken</key>
      <string>Your Activation Token</string>
      <key>publicKey</key>
      <string>Your Public Key</string>
      <key>hourlyCheck</key>
      <true/>
      <key>updatePrompts</key>
      <true/>
      <key>autoUpdate</key>
      <true/>
      <key>allowedAppInstalls</key>
      <array>
        <string>Example App</string>
        <string>Example App 2</string>
      </array>
      <key>excludedAppInstalls</key>
      <array>
        <string>Example App</string>
        <string>Example App 2</string>
      </array>
      <key>allowedAppUpdates</key>
      <array>
        <string>Example App</string>
        <string>Example App 2</string>
      </array>
      <key>excludedAppUpdates</key>
      <array>
        <string>Example App</string>
        <string>Example App 2</string>
      </array>
    </dict>
    <key>ScheduledUpdates</key>
    <dict>
      <key>runFrequency</key>
      <dict>
        <key>runType</key>
        <string>specifyFrequency</string>
        <key>frequencyOption</key>
        <string>oneWeek</string>
        <key>frequencyElapsedMode</key>
        <string>singlePromptMode</string>
      </dict>
      <key>runLimitations</key>
      <dict>
        <key>monday</key>
        <true/>
        <key>mondayStartTime</key>
        <string>00:00</string>
        <key>mondayEndTime</key>
        <string>23:59</string>
        <key>tuesday</key>
        <true/>
        <key>tuesdayStartTime</key>
        <string>00:00</string>
        <key>tuesdayEndTime</key>
        <string>23:59</string>
        <key>wednesday</key>
        <true/>
        <key>wednesdayStartTime</key>
        <string>00:00</string>
        <key>wednesdayEndTime</key>
        <string>23:59</string>
        <key>thursday</key>
        <true/>
        <key>thursdayStartTime</key>
        <string>00:00</string>
        <key>thursdayEndTime</key>
        <string>23:59</string>
        <key>friday</key>
        <true/>
        <key>fridayStartTime</key>
        <string>00:00</string>
        <key>fridayEndTime</key>
        <string>23:59</string>
        <key>saturday</key>
        <true/>
        <key>saturdayStartTime</key>
        <string>00:00</string>
        <key>saturdayEndTime</key>
        <string>23:59</string>
        <key>sunday</key>
        <true/>
        <key>sundayStartTime</key>
        <string>00:00</string>
        <key>sundayEndTime</key>
        <string>23:59</string>
      </dict>
      <key>deferralConfiguration</key>
      <dict>
        <key>deferralOption</key>
        <string>specifyDeferralLimit</string>
        <key>specifyLimit</key>
        <integer>2</integer>
      </dict>
      <key>gracePeriodMinutes</key>
      <integer>30</integer>
      <key>customIcon</key>
      <string>/usr/local/images/CustomIcon.png</string>
      <key>initialPromptOverlayIcon</key>
      <string>/usr/local/images/CustomIcon.png</string>
      <key>customInitialPromptSize</key>
      <dict>
        <key>promptHeight</key>
        <integer>330</integer>
        <key>promptWidth</key>
        <integer>640</integer>
      </dict>
      <key>customGracePromptSize</key>
      <dict>
        <key>promptHeight</key>
        <integer>330</integer>
        <key>promptWidth</key>
        <integer>640</integer>
      </dict>
      <key>customSelfServicePromptSize</key>
      <dict>
        <key>promptHeight</key>
        <integer>330</integer>
        <key>promptWidth</key>
        <integer>640</integer>
      </dict>
      <key>singleAppTitle</key>
      <string>Example Title</string>
      <key>multipleAppsTitle</key>
      <string>Example Title</string>
      <key>singleInitialQuitPromptMessage</key>
      <string>Example Message</string>
      <key>multipleInitialQuitPromptMessage</key>
      <string>Example Message</string>
      <key>singleSelfServiceQuitMessage</key>
      <string>Example Message</string>
      <key>multipleSelfServiceQuitMessage</key>
      <string>Example Message</string>
      <key>singleAppGracePeriodQuitMessage</key>
      <string>Example Message</string>
      <key>multipleAppGracePeriodQuitMessage</key>
      <string>Example Message</string>
      <key>customDeferButton</key>
      <string>Later</string>
      <key>customSkipButton</key>
      <string>Later</string>
      <key>customUpdateButton</key>
      <string>Update Now</string>
      <key>appListType</key>
      <string>vertical</string>
      <key>refreshInterval</key>
      <integer>60</integer>
      <key>acceptableAppBundleIDs</key>
      <array>
        <string>Example App</string>
        <string>Example App 2</string>
      </array>
      <key>acceptableAppAssertions</key>
      <array>
        <string>Example App</string>
        <string>Example App 2</string>
      </array>
      <key>acceptableDNDMode</key>
      <true/>
      <key>acceptableCameraUsage</key>
      <true/>
      <key>acceptableScreenSharing</key>
      <true/>
      <key>updateProgressPosition</key>
      <string>topright</string>
      <key>updateProgressPrompt</key>
      <string>noFocusPrompt</string>
      <key>updateProgressOverlayIcon</key>
      <string>/usr/local/images/CustomIcon.png</string>
      <key>autoRelaunchApps</key>
      <true/>
      <key>displayCompletePrompt</key>
      <true/>
    </dict>
    <key>ForcedUpdates</key>
    <dict>
      <key>runLimitations</key>
      <dict>
        <key>monday</key>
        <true/>
        <key>mondayStartTime</key>
        <string>00:00</string>
        <key>mondayEndTime</key>
        <string>23:59</string>
        <key>tuesday</key>
        <true/>
        <key>tuesdayStartTime</key>
        <string>00:00</string>
        <key>tuesdayEndTime</key>
        <string>23:59</string>
        <key>wednesday</key>
        <true/>
        <key>wednesdayStartTime</key>
        <string>00:00</string>
        <key>wednesdayEndTime</key>
        <string>23:59</string>
        <key>thursday</key>
        <true/>
        <key>thursdayStartTime</key>
        <string>00:00</string>
        <key>thursdayEndTime</key>
        <string>23:59</string>
        <key>friday</key>
        <true/>
        <key>fridayStartTime</key>
        <string>00:00</string>
        <key>fridayEndTime</key>
        <string>23:59</string>
        <key>saturday</key>
        <true/>
        <key>saturdayStartTime</key>
        <string>00:00</string>
        <key>saturdayEndTime</key>
        <string>23:59</string>
        <key>sunday</key>
        <true/>
        <key>sundayStartTime</key>
        <string>00:00</string>
        <key>sundayEndTime</key>
        <string>23:59</string>
      </dict>
      <key>customIcon</key>
      <string>/usr/local/images/CustomIcon.png</string>
      <key>initialPromptOverlayIcon</key>
      <string>/usr/local/images/CustomIcon.png</string>
      <key>customInitialPromptSize</key>
      <dict>
        <key>promptHeight</key>
        <integer>330</integer>
        <key>promptWidth</key>
        <integer>640</integer>
      </dict>
      <key>customGracePromptSize</key>
      <dict>
        <key>promptHeight</key>
        <integer>330</integer>
        <key>promptWidth</key>
        <integer>640</integer>
      </dict>
      <key>customTitle</key>
      <string>Example Title</string>
      <key>initialQuitPromptMessage</key>
      <string>Example Message</string>
      <key>gracePeriodQuitPromptMessage</key>
      <string>Example Message</string>
      <key>customDeferButton</key>
      <string>Later</string>
      <key>customUpdateButton</key>
      <string>Later</string>
      <key>refreshInterval</key>
      <integer>60</integer>
      <key>acceptableAppBundleIDs</key>
      <array>
        <string>Example App</string>
        <string>Example App 2</string>
      </array>
      <key>acceptableAppAssertions</key>
      <array>
        <string>Example App</string>
        <string>Example App 2</string>
      </array>
      <key>acceptableDNDMode</key>
      <true/>
      <key>acceptableCameraUsage</key>
      <true/>
      <key>acceptableScreenSharing</key>
      <true/>
      <key>updateProgressPosition</key>
      <string>topright</string>
      <key>updateProgressPrompt</key>
      <string>noFocusPrompt</string>
      <key>updateProgressOverlayIcon</key>
      <string>/usr/local/images/CustomIcon.png</string>
      <key>autoRelaunchApps</key>
      <true/>
      <key>displayCompletePrompt</key>
      <true/>
    </dict>
  </dict>
</plist>

<aside> <img src="https://prod-files-secure.s3.us-west-2.amazonaws.com/103d340e-2942-4102-bf59-017fbac37c50/ca136360-be2d-4aee-bcf4-6ce5b80e1c28/zappl.png" alt="https://prod-files-secure.s3.us-west-2.amazonaws.com/103d340e-2942-4102-bf59-017fbac37c50/ca136360-be2d-4aee-bcf4-6ce5b80e1c28/zappl.png" width="40px" />

Navigation

About Zappl

Requirements

Security

macOS Components

Frequently Asked Questions

Deploying Zappl

Deploy Using Jamf Pro

Categories

Configuration Profiles

Deploying the Installer

Additional Scripts

Self Service Updates

Extension Attributes

Deploy Using Other MDMs

Configuration Profiles

Deploying the Installer

App Updates

Scheduled Update Prompts

Forced Updates

App Installs

Online Portal

Accounts

Dashboard

Devices

Device Records

Applications

Reports

Settings

Custom Message Variables

Command Line Options

Logs and Error Capture

Troubleshooting

Uninstalling Zappl

</aside>