Changing Android device settings unavailable in AirWatch native GUI (Zebra MX)

Zebra devices have a cool set of extensions called MX. It can do tons of things. But, can we expect every EMM vendor to timely implement them natively in their consoles?

Unlike SOTI (which can use SOTIscript for advanced features), AirWatch only allows changing settings that you can see in the GUI. If it’s not in console GUI – you can’t have it. However, there are a few exceptions.

In this post we will talk about one extremely simple, yet little-known way of extending AW functionality beyond the GUI limitations. Read on if you want to know how to apply any MX setting via AirWatch to your Zebra device.

The flow

AirWatch has a powerful Product Provisioning mechanism, which can be used to deliver fine-grained payloads to the device. One of such payloads is called “Apply Custom Settings”. One such “custom setting” can be Zebra MX XML, created with Zebra’s native tools. See where this is going?

Here’s how it works:

  1. Prepare the XML via Zebra StageNow tool
  2. Create a File/Action to apply this XML
  3. Create a Product using this file actions
  4. Assign the Product to your selected devices and enjoy!

I will only cover #1 and #2 here, since the rest is generic AirWatch Product Provisioning. Feel free to contact me for more details, though.

1. Prepare the XML

This step is actually simple. Just create a staging profile using Zebra’s  free device staging tool called StageNow. The tool is extremely straightforward, but has a few caveats. I had written a training on it, when I was working for Zebra Learning Centre, you can watch it here.

So, launch StageNow and build a profile to change whatever settings you want. Once the profile is completed, click the Export for MDM button in the Review screen and save the XML file.

StageNow profile Review screen with "Export for MDM" button highlighted
StageNow profile Review screen with “Export for MDM” button highlighted

Here’s my simple demo XML that turns Bluetooth off. For testing you want something that is easy to control. Of course, you can change multiple settings at the same time – the entire MX Profile will be applied.

<characteristic version="4.3" type="WirelessMgr">
    <parm name="BluetoothState" value="2" />

That was it! Now, proceed to the AirWatch console…

2. Create and deploy the payload in AirWatch

This is really easy:

  1. Navigate to Devices -> Staging & Provisioning -> Components -> Files/Actions (yes, it is really well hidden) and create a new one. Choose the Android platform and give it a name etc.
  2. In the Files tab, upload your XML file from StageNow.
  3. In the Manifest tab, add Apply Custom Settings to the Install Manifest and choose your file from the dropdown.

This is it!

Now, include this File/Action into your Product or Product Set, assign, and see it working! There are just a few things to consider…

Uninstall considerations

What should happen, when the File/Action is uninstalled? For instance, should I revert to the previous setting, and how?

If our current File/Action setup gets uninstalled, the MX profile will not be un-applied – the settings are not restored/reverted. You may be fine with that, but what to do if you are not?

One of the ways would be to create another MX profile to un-do your settings and include it into the uninstall manifest. For my Bluetooth setting it would look like this

  • Create MX Profile in StageNow that turns BT on (or just edit XML file with value=”1)
  • In the Files tab of my File/Action, upload both BT_off.xml and BT_on.xml
  • Apply BT_on.xml in Uninstall manifest (“Apply Custom Settings”).

The only thing you really cannot do (well, you can, but it is too complicated to bother in most cases) is to preserve original setting value and the restore it. But in most cases you don’t need that, as you push configuration baselines – previous setting states should not matter.

For that sake, in many cases you would not even bother with uninstall manifest, since your new baseline will dictate BT status anyway. It may be useful for other cases, however (deleting files, etc).

Traceability considerations

Now that you are pushing settings that AW does not know about, how do you know they exist on the device? There is a number of ways to achieve this, all out of scope of this article, but I may write something later…

  1. Just use the fact that the File/Action is installed.
    1. The simples one – nothing to do! 😊
    2. This works nice if your MX profiles are atomic (one setting per File/Action)
    3. AW does not have nice mechanisms such as “ show me all devices that have File/Action X installed”, so overall this method is very limited.
  2. Use Custom Attributes
    1. I am a big fan of attributes ever since the days of MSP (~2009). If you know how to use them, and have EMM system that supports them well – you will rule your deployment with ease and grace!
    2. In AW, custom attributes are complicated, and support is limited. But it is easy to create an XML file, which, when put in the right location, will automatically cause the agent to report the necessary values to the console. All you need to do is to build the XML file and include it in the Files tab of your File/Action (delete/replace during uninstall as well!).

In both cases, however, there is absolutely no guarantee that the setting was not changed by somebody else! So use with caution.


You now should be able to:

  • Apply ANY MX setting to Zebra device using AW
  • Explain how simple the process really is
  • Consider factors such as uninstall behaviour and traceability in your deployment
  • Tell others how cool and advanced you are with AirWatch!

Was it useful? Do you want a post on Custom Attributes or Product Provisioning? Let me know your thoughts!


13 thoughts on “Changing Android device settings unavailable in AirWatch native GUI (Zebra MX)

Add yours

  1. Even more good stuff!. thanks again. BTW – does SOTIscript support MX? (too lazy to check myself 🙂


  2. Aren’t the exact same features supported in MobiControl as well with the mxconfig SOTIScript? I use them all the time. Does AirWatch hold any advantage over MobiControl in that regard?

    Liked by 1 person

    1. You are absolutely right, Matt. In fact, this is the subject of my next post. Trying to cover the lesser-known features of both MDMs I have been working with.


  3. Hi Arsen!

    I’d like to add an MX based setting to AW but do not see what you describe:

    The version is:

    Am I missing something or just need a higher AW version?

    Best regards

    Radim Kadlec

    Enterprise Mobility Consultant

    Tel.: +420 606 099 000


    *From:* Arsen Bandurian: Technical Blog *Sent:* Wednesday, February 14, 2018 9:31 AM *To:* *Subject:* [New post] Changing Android device settings unavailable in AirWatch native GUI (Zebra MX)

    apcsb posted: “Zebra devices have a cool set of extensions called MX. It can do tons of things. But, can we expect every EMM vendor to timely implement them natively in their consoles? Unlike SOTI (which can use SOTIscript for advanced features), AirWatch only allows c”


  4. I came across your post in search of how to deploy custom payloads via AW. Do you have any idea if there’s a similar tool to do things with Samsung devices?


    1. Not the tool, but you can use the Custom payload in the standard Android profile. Check the Knowledge Base on for supported examples.
      Otherwise, we need to wait for Samsung to release their version of OEMconfig.


      1. Thank you for the quick response.

        Apologies, could you point me to a custom payload example? I had already searched on before posting, but did not find anything useful for setting a default browser. I searched again this morning, and perhaps I’m missing something.

        I come across how to do it ( but I don’t see any concrete examples.

        I’m guessing it also could be specific to each OEM, is that your understanding as well?


  5. Hello Arsen,
    I followed your procedure but I get a Failed in Last Job Status. From logs I can see following error message: “ERR Applying of custom settings failed Custom Settings is not supported”.
    What am I missing?


    1. Hi, Pietro. I need to know at least the device type, OD version, enrollment type, and if the same XML worked via StageNiw


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

Blog at

Up ↑

%d bloggers like this: