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 beginning 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. Save, but do not publish, your profile.
  7. Select the radio button from the Profiles List View for the row of the profile you want to customize.

  8. Select the XML button at the top to view the profile X
  9. Find the section of text starting with <characteristic> ... <characteristic> that you configured previously, for example, Restrictions or Passcode. The section contains a configuration type identifying its purpose, for example, restrictions.
  10. Copy this section of text and close the XML View. Open your profile.
  11. 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]>.
  12. 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.

  13. Select Save & Publish.