The Custom Settings payload provides a way to use Windows Desktop functionality that AirWatch does not currently support through its native payloads. If you want to use the new features, you can use the Custom Settings payload and XML code to enable or disable certain settings manually.


You must write your own SyncML code for Windows Desktop profiles. Microsoft publishes a Configuration Service Provider reference site available on their web site.

The Custom Settings profiles appends the appropriate code to the beginnging and the end of the code. You must write the appropriate code between any <Add>, <Replace>, <Delete>, or <Get> tags. Before adding the code to the profile, remove all whitespace from the XML code.

Example code:



To configure a Custom payload:

  1. Navigate to Devices > Profiles > List View > Add and select Add Profile.

  2. Select Windows and then select Windows Desktop.
  3. Select User Profile or Device Profile.
  4. Configure the profile General settings.

    These settings determine how the profile deploys and who receives it. For more information on General settings, see Add General Profile Settings.

  5. Configure the applicable payload (for example, Restrictions or Passcode).

    You can work on a copy of your profile, saved under a "test" organization group, to avoid affecting other users before you are ready to Save and Publish.

  6. Select the Custom Settings payload and select Configure. Paste the XML you copied in the text box. The XML code you paste must contain the complete block of code, from <[characteristic]> to </[characteristic]>.
  7. Remove the original payload you configured by selecting the base payload section and selecting the minus [-] button. You can now enhance the profile by adding custom XML code for the new functionality.


    Any device not upgraded to the latest version ignores the enhancements you create. Since the code is now custom, test the profile devices with older versions to verify expected behavior.

  8. Select Save & Publish.