The "SmartDocs" bar can customize this page to show only the features present on a particular Zebra device.
OSX, MX and Android version information for a device can be found in the Android Settings panel or by querying the device through ADB, EMDK or the MX CSP. More info.
The UI Manager (UiMgr) provides control of miscellaneous UI configuration settings, such as those for language and locale, the device notification pull-down, Quick Settings controls, default input device and Clipboard behavior.
Android devices contain a variety of System applications that access UI elements spread throughout the OS. In some cases, one or more of these "standard" UI elements were deemed undesirable by Zebra customers and/or partners for devices deployed in an enterprise. The UiMgr provides control over these UI elements and the option of disabling Android behaviors or features with the potential to hinder the productivity of device users engaged in specific business tasks.
Security Warning: The UiMgr permits the "Network may be monitored..." message to be suppressed. This important safeguard is intended to warn device users of a potential security risk. Administrators should not suppress this message unless CA certificates have been properly vetted before installation on a device, and should ensure that no untrusted certificates can be subsequently installed while the message remains suppressed.
Controls whether the Clipboard function can be used, potentially enabling a device user to move data from one app to another.
Parm Name: ClipBoardUsage
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained. |
OSX: 4.2+ MX: 4.2+ |
||
1 | Enable | Enables app data to be copied to the Clipboard and pasted into other apps on the device. |
OSX: 4.2+ MX: 4.2+ |
||
2 | Disable | Disables the Clipboard, preventing the user from copying app data to the clipboard and pasting it into other apps on the device. |
OSX: 4.2+ MX: 4.2+ |
Used to immediately clear the contents of the Clipboard, preventing data that was stored there from being pasted at any time thereafter. If Clipboard functions are allowed by an app that handles sensitive data, Zebra recommends using this parameter to clear sensitive data from Clipboard upon exiting the app to prevent the data from later being pasted elsewhere.
Parm Name: ClipBoardClear
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
true | true | Clears the Clipboard, erasing any content that was previously copied and preventing such content from being pasted elsewhere. |
OSX: 4.2+ MX: 4.2+ |
||
false | false | Causes no change to the contents of the Clipboard. |
OSX: 4.2+ MX: 4.2+ |
Controls whether a device user has access to Android Clipboard Share, features that automate Clipboard data sharing among apps on and off the device. Disabling Clipboard Share does NOT prevent a user from manually pasting Clipboard data from one app to another on the device. To prevent this action, see Clipboard Usage.
Note: Supported only on devices running Android 10 or later. Android 11 requires MX 11.3 or later.
Parm Name: ClipboardShare
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained. |
MX: 10.5+ |
||
1 | Enable | Allows use of Android Clipboard Share functions when using the on-device Clipboard, potentially allowing Clipboard contents to be shared among apps on and off the device. |
MX: 10.5+ |
||
2 | Disable | Blocks Android Clipboard Share functions when using the on-device Clipboard. |
MX: 10.5+ |
Used to select an Action to perform on the named external keyboard specified in the External Keyboard Name parameter.
Note: If the named keyboard is not connected when configuration settings are deployed, settings are applied the next time the keyboard is plugged in. If multiple StageNow Profiles containing different layout names are created, the layout in the last applied Profile becomes the default. This is an experimental feature and is NOT covered by Zebra Technical Support.
Parm Name: ExternalKeyboard
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change device settings; any previously selected setting is retained. |
MX: 10.5+ Android API: 30+ |
||
1 | Add/Replace Keyboard Layout Mapping | Adds a Keyboard Layout (language) to the device or replaces one of the same name. |
MX: 10.5+ Android API: 30+ |
||
2 | Remove Keyboard Layout Mapping | Removes a Keyboard Layout (language) from the device. |
MX: 10.5+ Android API: 30+ |
||
3 | Remove All Keyboard Layout Mappings | Removes all Keyboard Layouts (languages) from the device. |
MX: 10.5+ Android API: 30+ |
Used to enter a Keyboard Name to add or replace a Keyboard Layout (language) on the device. Note: If a layout exists on the device with the same name as one being added, the existing layout is replaced by the layout being added. Keyboard Names are NOT case sensitive.
To view the name of the connected external keyboard, go to the Android Settings panel and select System > Languages & input > Physical keyboard.
Parm value input rules:
Shown if: External Keyboard Action is "Add/Replace Keyboard Layout Mapping"
Parm Name: ExternalKeyboardName
Requires:
- MX: 10.5+
- Android API: 30+
Used to enter a Keyboard Name from which to remove a Keyboard Layout (language). The Keyboard Name entered must be among those listed in the Input Settings panel on the device. Keyboard Names are NOT case sensitive.
Parm value input rules:
Shown if: External Keyboard Action is "Remove Keyboard Layout Mapping"
Parm Name: ExternalOptionalKeyboardName
Requires:
- MX: 10.5+
- Android API: 30+
Used to enter the name of the Keyboard Layout being configured. This required field and MUST contain the name of a layout listed in the "Keyboard layouts" panel on the device. NOTE: Layout Names ARE case sensitive.
To view a list of Keyboard Layouts:
Parm value input rules:
Note: External keyboard MUST be connected when applying this parameter. If multiple StageNow Profiles containing different layout names are created, the layout in the last applied Profile becomes the default.
Shown if: External Keyboard Action is "Add/Replace Keyboard Layout Mapping"
Parm Name: ExternalKeyboardLayout
Requires:
- MX: 10.5+
- Android API: 30+
Controls whether AutoCorrect functionality is accessible on the device. AutoCorrect can be used to save commonly entered words or industry-specific words or phrases and offer them as corrections to potentially mistyped words. Such functionality could present a security risk by exposing sensitive information to subsequent device users that are not authorized to view or reuse that information.
Note: This parameter does not turn the AutoCorrect function on or off or configure any of its functions. When AutoCorrect is enabled, an administrator or device user must still use the System Settings panel turn the function on or off and configure its functions. When disabled, AutoCorrect functionality cannot be used on the device.
Parm Name: AutoCorrectUsage
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained. |
MX: 4.3+ Android API: 1+ |
||
1 | Enable | Enables use of the AutoCorrect function, allowing an administrator or device user to the turn the function on and off and configure its settings using the System Settings panel. |
MX: 4.3+ Android API: 1+ |
||
2 | Disable | Disables use of the AutoCorrect function, preventing an administrator or device user from turning the function on or off and configuring its settings using the System Settings panel. |
MX: 4.3+ Android API: 1+ |
Used to prevent use of the HOME key to exit the current app and run the Home Screen app. This might be desirable when the device is devoted to running a single application, such as that of a kiosk. By blocking use of the HOME key, a common method of navigating away from the application (whether intentional or not) can be eliminated.
Note: Enabling this parameter does not affect the "long press" behavior of the HOME key. To completely prevent all HOME key functionality, use the Key Mapping Manager (on supported devices) to disable the HOME key or map it to a desired behavior.
Parm Name: HomeKeyUsage
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) will cause no change to HOME key functionality; any previously selected setting will be retained. |
OSX: 1.0+ MX: 4.3+ |
||
1 | Enable | Allows use of the HOME key to exit the current app and launch the Home Screen app. |
OSX: 1.0+ MX: 4.3+ |
||
2 | Disable | Prevents use of the HOME key, which would otherwise exit the current app and run the Home Screen app. |
OSX: 1.0+ MX: 4.3+ |
This is the On/Off switch for device response to a "long-press" of the HOME key, which launches the Google Assistant.
Parm Name: LongPressHomeKeyUsage
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change to settings; any previously selected setting is retained. |
OSX: 7.7+ MX: 8.2+ |
||
1 | Enable | Allows the device to respond to a "long-press" of the HOME key. |
OSX: 7.7+ MX: 8.2+ |
||
2 | Disable | Prevents the device from responding to a "long-press" of the HOME key. |
OSX: 7.7+ MX: 8.2+ |
This is the On/Off switch for launching the Clock app on the device by tapping the date in the Notifications drop-down panel.
Parm Name: NotificationDate
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change to settings; any previously selected setting is retained. |
OSX: 7.7+ MX: 8.2+ |
||
1 | Enable | Allows the Clock app to launch on the device by tapping the date in the Notifications drop-down panel. |
OSX: 7.7+ MX: 8.2+ |
||
2 | Disable | Prevents the Clock app from launching on the device by tapping the date in the Notifications drop-down panel. |
OSX: 7.7+ MX: 8.2+ |
Controls whether the message "Network may be monitored..." is displayed on the device when the device user connects to certain types of networks. This message is generally associated with networks that implement a public key infrastructure and require a root certificate on the device before a client will be allowed to connect.
Security Warning: The "Network may be monitored..." message is a safeguard intended to warn device users of a potential security risk. Administrators should not suppress this message unless CA certificates have been properly vetted before installation on a device, and should ensure that no untrusted certificates can be subsequently installed while the message remains suppressed.
Note: On TC20/TC25 devices, available only when running Android 8.x Oreo and higher.
Parm Name: NetworkMonitorNotification
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting will be retained. |
OSX: 6.0+ MX: 6.1+ |
||
1 | Turn On | Allows "Network may be monitored..." notifications to be displayed. |
OSX: 6.0+ MX: 6.1+ |
||
2 | Turn Off | Prevents "Network may be monitored..." notifications from being displayed. |
OSX: 6.0+ MX: 6.1+ |
This is the On/Off switch for Multi-user mode on the device, which can provide separate user accounts, data and apps or app restrictions on a shared device. Zebra devices support a maximum of 4 users.
This feature is supported only on SDM660-platform devices, which includes (but is not limited to):
Note: Supported on SDM660-platform devices only. Zebra devices support a maximum of 4 users.
Parm Name: MultiUser
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change to the Multi-user setting; any previously selected setting is retained. |
OSX: 8.5+ MX: 8.1+ |
||
1 | Enable | Enables multiple users on the device. |
OSX: 8.5+ MX: 8.1+ |
||
2 | Disable | Disables multi-user mode on the device. |
OSX: 8.5+ MX: 8.1+ |
Permits the selection of the device's Locale. A locale is the combination of a language and a region in which that language is spoken. Languages are identified by two lower-case letters; regions are identified by two upper-case letters. The locale joins the two letter-pairs with an underscore ("_") character. For example, "en_US" is the locale specification for "English spoken in the United States," and "fr_CA" is the locale specification for "French spoken in Canada."
When changing the Locale, it also might be desirable to change the Default Input Method to one that is suitable for entry of characters for the language associated with the selected Locale. Setting a particular Input Method as the Default Input Method does not prevent the device user from manually selecting a different Input Method, it merely determines which Input Method will come up automatically each time that parm is invoked.
Parm value input rules:
en_US
Parm Name: CurrentLocale
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) will cause no changes to be made to the Locale; any previously selected setting will be retained. |
OSX: 1.3+ MX: 4.3+ |
||
98 | Extended | Permits selection from the Extended List of Locales |
MX: 5.1+ |
||
99 | Custom | Permits selection from the Custom List of Locales |
MX: 5.1+ |
||
en_CA | CANADA | English spoken in Canada |
OSX: 1.3+ MX: 4.3+ |
||
fr_CA | CANADA_FRENCH | French spoken in Canada |
OSX: 1.3+ MX: 4.3+ |
||
zh_CN | CHINA | Chinese spoken in China |
OSX: 1.3+ MX: 4.3+ |
||
zh | CHINESE | Chinese (non-region specific) |
OSX: 1.3+ MX: 4.3+ |
||
en | ENGLISH | English (non-region specific) |
OSX: 1.3+ MX: 4.3+ |
||
fr_FR | FRANCE | French spoken in France |
OSX: 1.3+ MX: 4.3+ |
||
fr | FRENCH | French (non-region specific) |
OSX: 1.3+ MX: 4.3+ |
||
de | GERMAN | German (non-region specific) |
OSX: 1.3+ MX: 4.3+ |
||
de_DE | GERMANY | German spoken in Germany |
OSX: 1.3+ MX: 4.3+ |
||
it | ITALIAN | Italian (non-region specific) |
OSX: 1.3+ MX: 4.3+ |
||
it_IT | ITALY | Italian spoken in Italy |
OSX: 1.3+ MX: 4.3+ |
||
ja_JP | JAPAN | Japanese spoken in Japan |
OSX: 1.3+ MX: 4.3+ |
||
ja | JAPANESE | Japanese (non-region specific) |
OSX: 1.3+ MX: 4.3+ |
||
ko_KR | KOREA | Korean spoken in Korea |
OSX: 1.3+ MX: 4.3+ |
||
ko | KOREAN | Korean (non-region specific) |
OSX: 1.3+ MX: 4.3+ |
||
zh_CN | PRC | Alternate Chinese spoken in China |
OSX: 1.3+ MX: 4.3+ |
||
zh_CN | SIMPLIFIED_CHINESE | Alternate Chinese spoken in China |
OSX: 1.3+ MX: 4.3+ |
||
zh_TW | TAIWAN | Chinese spoken in Taiwan |
OSX: 1.3+ MX: 4.3+ |
||
zh_TW | TRADITIONAL_CHINESE | Alternate Chinese spoken in Taiwan |
OSX: 1.3+ MX: 4.3+ |
||
en_GB | UK | English spoken in Great Britain/United Kingdom |
OSX: 1.3+ MX: 4.3+ |
||
en_US | US | English spoken in the United States of America (USA) |
OSX: 1.3+ MX: 4.3+ |
||
es_ES | SPAIN_SPANISH | Spanish spoken in Spain |
OSX: 1.3+ MX: 5.0+ |
||
es_US | US_SPANISH | Spanish spoken in the United States of America (USA) |
OSX: 1.3+ MX: 5.0+ |
||
pt_BR | BRAZIL_PORTUGUESE | Portuguese spoken in Brazil |
OSX: 1.3+ MX: 5.0+ |
||
pt_PT | PORTUGAL_PORTUGUESE | Portuguese spoken in Portugal |
OSX: 1.3+ MX: 5.0+ |
Controls whether the current battery-charge percentage is displayed. When shown, the percentage appears in the Android Status Bar at the top of the screen.
Parm Name: ShowBatteryPercentage
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained. |
MX: 10.1+ |
||
1 | Turn On | Causes battery-charge percentage to be shown in the Status Bar. |
MX: 10.1+ |
||
2 | Turn Off | Causes the battery-charge percentage to be hidden. |
MX: 10.1+ |
This is the On/Off switch for Split Screen functionality on the device, which allows two apps to be usable at the same time, each with its own section of the screen. When enabled, Split Screen mode is accessed on some devices by long-pressing the "Recent Apps" button.
Parm Name: SplitScreenMode
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change to the Split-screen setting; any previously selected setting is retained. |
OSX: 7.7+ MX: 8.1+ |
||
1 | Enable | Allows two apps to be usable at the same time by sharing screen space. |
OSX: 7.7+ MX: 8.1+ |
||
2 | Disable | Prevents more than one app from being visible at a time. |
OSX: 7.7+ MX: 8.1+ |
Controls whether the device user is permitted to change the state (On/Off) of "Do Not Disturb" mode on the device, which toggles app notification sounds and messages. When Enabled (option 1), the user can turn notifications on or off using the Notification pull-down or Android Settings panel. When Disabled, the user can view the DND state but cannot change it. Note: This parameter does NOT change the state of DND mode, only the device user's ability to do so.
This feature is supported only on SDM660-platform devices, which includes (but is not limited to):
Note: Supported on SDM660-platform devices only.
Parm Name: DND
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained. |
OSX: 8.5+ MX: 8.1+ |
||
1 | Enable | Allows the device user to control the state of "Do Not Disturb" mode on the device, potentially stopping app notifications and sounds. |
OSX: 8.5+ MX: 8.1+ |
||
2 | Disable | Prevents the device user from changing the state of "Do Not Disturb" mode on the device. |
OSX: 8.5+ MX: 8.1+ |
Controls whether to present the Bluetooth Pairing Pop-up during a pairing operation, useful mainly when the device user is responsible for pairing. If one or more applications are expected to control pairing operations, suppressing the Pairing Pop-up can reduce the potential for user interference with the pairing process.
Parm Name: BluetoothPairingPopupUsage
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change to Bluetooth Pairing Pop-up setting; any previously selected setting is retained. |
OSX: 4.3+ MX: 4.3+ |
||
1 | Enable | Allows the Bluetooth Pairing Pop-up to be presented during pairing operations. |
OSX: 4.3+ MX: 4.3+ |
||
2 | Disable | Prevents display of the Bluetooth Pairing Pop-up during pairing operations. |
OSX: 4.3+ MX: 4.3+ |
This is the On/Off switch for device response to a "long-press" of an app icon in the Recent Apps Header. When enabled, long-pressing an app icon allows the device user to access application information and to potentially perform undesireable actions, such as stopping the app.
Parm Name: AppInfoIconOnRecentAppHeader
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change to settings; any previously selected setting is retained. |
OSX: 7.7+ MX: 8.2+ |
||
1 | Enable | Allows the device to respond to a "long-press" on an app icon in the Recent Apps Header. |
OSX: 7.7+ MX: 8.2+ |
||
2 | Disable | Prevents the device from responding to a "long-press" of an app icon in the Recent Apps Header. |
OSX: 7.7+ MX: 8.2+ |
Permits the selection of the device's Custom Locale. A locale is the combination of a language and a region in which that language is spoken. Languages are identified by two lower-case letters; regions are identified by two upper-case letters. The locale joins the two letter-pairs with an underscore ("_") character. For example, "en_US" is the locale specification for "English spoken in the United States," and "fr_CA" is the locale specification for "French spoken in Canada."
When changing the Locale, it also might be desirable to change the Default Input Method to one that is suitable for entry of characters associated with the language of the selected Locale. Setting a particular Input Method as the Default Input Method does not prevent the device user from manually selecting a different Input Method, it merely determines which Input Method will come up automatically each time that parm is invoked.
Parm value input rules:
en_US
Shown if: Current Locale value is "Custom" (99)
Parm Name: CustomLocale
Requires:
- MX: 5.1+
Permits the selection of the device's locale from the list of Extended Locales. A locale is the combination of a language and a region in which that language is spoken. Languages are identified by two lower-case letters; regions are identified by two upper-case letters. The locale joins the two letter-pairs with an underscore ("_") character. For example, "en_US" is the locale specification for "English spoken in the United States," and "fr_CA" is the locale specification for "French spoken in Canada."
When changing the Locale, it also might be desirable to change the Default Input Method to one that is suitable for entry of characters for the language associated with the selected Locale. Setting a particular Input Method as the Default Input Method does not prevent the device user from manually selecting a different Input Method, it merely determines which Input Method will come up automatically each time that parm is invoked.
Parm value input rules:
en_US
Shown if: Current Locale value is "Extended" (98)
Parm Name: ExtendedLocale
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
en_AU | AUSTRALIA_ENGLISH | Not supported on TC55 KitKat |
OSX: 1.3+ MX: 5.1+ |
||
en_IN | INDIA_ENGLISH | Not supported on TC55 KitKat |
OSX: 1.3+ MX: 5.1+ |
||
sv_SE | SWEDEN_SWEDISH |
OSX: 1.3+ MX: 5.1+ |
|||
nb_NO | NORWAY_NORWEGIAN-BOKMAL |
OSX: 1.3+ MX: 5.1+ |
|||
fi_FI | FINLAND_FINISH |
OSX: 1.3+ MX: 5.1+ |
|||
da_DK | DENMARK_DANISH |
OSX: 1.3+ MX: 5.1+ |
Controls whether to change the Default Input Method (i.e. a soft keyboard) when that change is requested programmatically or manually by the device user. Setting a particular Input Method as the Default Input Method does not prevent the device user from manually selecting a different Input Method, it merely determines which Input Method will come up automatically each time that parm is invoked. When changing the Current Locale, it may desirable to also change the Default Input Method to one that is suitable for entry of characters that are associated with the selected Locale.
Parm Name: InputMethodAction
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) will cause no change to be made to the Current Default Input Method; any previously selected setting will be retained. |
MX: 4.3+ Android API: 16+ |
||
1 | Change Current Input Method | This value will change the Current Default Input Method. |
MX: 4.3+ Android API: 16+ |
Used to enter the Android Class Name of a user-defined Input Method to be made the Default Input Method.
Note: The specified Class Name is used in conjunction with the Package Name and must match the name of the class that implements an Input Method within an Android application that is already installed and that has the specified Package Name. If an attempt is made to enter a Class Name that does not match an installed Input Method, an error will be returned.
Parm value input rules:
Shown if: The "Input Method Action" is "Change Current Input Method" and the "Select a Default Input Method Option" is "User defined Input Method"
Parm Name: InputMethodClassName
Requires:
- MX: 4.3+
- Android API: 16+
Allows the selection of the Default Input Method (i.e. the soft keyboard). If the selected Input Method is not already enabled, this parameter will first enable it and then set it as the new default. The desired Input Method must have been previously installed and must be specified using its Android Package Name and Class Name.
Shown if: The "Input Method Action" is "Change Current Input Method"
Parm Name: InputMethodOption
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
1 | English | Sets the standard English Input Method as the Default Input Method. |
MX: 4.3+ Android API: 16+ |
||
2 | Japanese | Sets the standard Japanese Input Method as the Default Input Method. |
MX: 4.3+ Android API: 16+ |
||
3 | Chinese(China) | Sets the standard Chinese Input Method as the Default Input Method. |
MX: 4.3+ Android API: 16+ |
||
4 | User defined Input Method | Sets a non-standard user-defined Input Method as the Default Input Method. |
MX: 4.3+ Android API: 16+ |
Controls whether the "Gear" icon is displayed in the Android Notifications panel. The Gear icon provides immediate access to Wi-Fi, Bluetooth, GPS and other commonly used System settings without having to go through the Settings panel. The Notifications panel is accessed from most applications by dragging downward from the Notification/Status bar at the top of the Android screen. Hiding the Gear icon can prevent a device user from accessing those Settings and changing device behavior.
Parm Name: NotificationSettings
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) will cause no change to visibility of the Gear icon in the Notifications panel; any previously selected setting will be retained. |
OSX: 5.1+ MX: 5.1+ |
||
1 | Show | Shows the Gear icon in the Notifications panel. |
OSX: 5.1+ MX: 5.1+ |
||
2 | Hide | Hides the Gear icon in the Notifications panel. |
OSX: 5.1+ MX: 5.1+ |
Used to enter the Android Package Name of a user-defined Input Method to be made the Default Input Method (i.e. a soft keyboard).
Note- The specified Package Name must match the Package Name of an Input Method that is already installed. If an attempt is made to enter a Package Name that does not match an installed Input Method, an error will be returned in the Result XML document.
Parm value input rules:
com.mycompany.myinputmethod
Shown if: The "Input Method Action" is "Change Current Input Method" and the "Select a Default Input Method Option" is "User defined Input Method"
Parm Name: InputMethodPackageName
Requires:
- MX: 4.3+
- Android API: 16+
Controls whether a device user will be allowed to "pull down" the Notifications/Status bar and access the Notifications panel. Depending on the Android version, the Notifications panel displays application alerts, text messages, widgets and other notifications, and provides access to device Settings. Preventing access to the Notification Pulldown can prevent a device user from accessing device Settings and other system objects that might allow a user to change system behavior or navigate away from the current application.
Parm Name: NotificationPullDown
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) will cause no change to ability of the device user to pull down the Notifications panel; any previously selected setting will be retained. |
OSX: 5.1+ MX: 5.1+ |
||
1 | Enable | Allows the Notifications panel to be pulled down. |
OSX: 5.1+ MX: 5.1+ |
||
2 | Disable | Prevents the Notifications panel from being pulled down. |
OSX: 5.1+ MX: 5.1+ |
Controls whether Quick Settings can be accessed using a two-finger downward swipe gesture on some versions of Android. Quick Settings icons provide immediate access to Wi-Fi, Bluetooth, GPS and other commonly used System settings without having to go through the Settings panel. Disabling Quick Settings access can prevent a device user from changing device behavior.
Note: This parameter is superseded by the "System Settings Access" parameter of Access Manager. If Reduced Access is enabled, later attempts enable Quick Settings result in failure.
Note: Superseded by the System Settings Access parameter of Access Manager. On TC20/TC25 devices, available only when running Android 8.x Oreo and higher.
Parm Name: QuickSettings
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) will cause no change to the accessibility of Quick Settings icons using a two-finger downward swipe; any previously selected setting will be retained. |
OSX: 5.2+ MX: 5.2+ |
||
1 | Enable | Enables access to Quick Settings using a two-finger downward swipe. |
OSX: 5.2+ MX: 5.2+ |
||
2 | Disable | Disables access to Quick Settings using a two-finger downward swipe. |
OSX: 5.2+ MX: 5.2+ |
This is the On/Off switch for the on-screen Navigation Bar, which contains the BACK, HOME and RECENT soft keys. Disabling the Navigation Bar prevents the user from quitting the currently running app by means of those keys. This parameter applies only to the soft keys; it does not control capacitive or hardware keys, which can be disabled separately using the Keymapping Manager.
Also see the Recent App Button Usage parameter elsewhere on this page.
Parm Name: NavigationBarUsage
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) will cause no setting change; any previously selected setting will be retained. |
OSX: 6.2+ MX: 7.1+ |
||
1 | Enable | Enables the navigation soft keys (BACK, HOME and RECENT) on the screen-bound Navigation Bar to be displayed and usable. |
OSX: 6.2+ MX: 7.1+ |
||
2 | Disable | Disables the navigation soft keys (BACK, HOME and RECENT) on the screen-bound Navigation Bar. |
OSX: 6.2+ MX: 7.1+ |
Controls access to the Android Recent Apps button, which displays a list of applications recently accessed on the device and from which the user can re-launch. Note: Disabling the recent apps button prevents the user from configuring the device for multi-window operation.
Parm Name: RecentAppButtonUsage
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no setting change; any previously selected setting is retained. |
OSX: 7.2+ MX: 7.1+ |
||
1 | Enable | Enables the Recent Apps button, which displays a list of recently used apps that can be viewed and launched. |
OSX: 7.2+ MX: 7.1+ |
||
2 | Disable | Disables the Recent Apps button, preventing the display and launch of recently used apps. |
OSX: 7.2+ MX: 7.1+ |
Controls the "Magnification gesture" setting on the device, which is found in the Accessibility section of the Android Settings Panel. By turning this feature on (option 1), triple-tapping the screen magnifies the device display (except navigation bar and keyboard).
Parm Name: MagnificationGesture
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change on the device; any previously selected setting is retained. |
MX: 8.0+ Android API: 24+ |
||
1 | Turn On | Allows screen magnification by use of a touch gesture. |
MX: 8.0+ Android API: 24+ |
||
2 | Turn Off | Prevents screen magnification by use of a touch gesture. |
MX: 8.0+ Android API: 24+ |
Controls whether each password character is displayed briefly on the screen as it is entered; otherwise masked at all times. This parameter controls the "Security & Location" function of the Settings panel.
Parm Name: ShowPasswords
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change on the device; any previously selected setting is retained. |
MX: 9.1+ Android API: 26+ |
||
1 | Turn On | Allows each password character to be displayed briefly as it is typed. |
MX: 9.1+ Android API: 26+ |
||
2 | Turn Off | Prevents passwords from being displayed. |
MX: 9.1+ Android API: 26+ |
Controls whether to display the virtual keyboard on the device screen while a physical keyboard is active.
Parm Name: ShowVirtualKeyBoard
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change on the device; any previously selected setting will be retained. |
MX: 8.0+ Android API: 26+ |
||
1 | Show | Shows the Gear icon in the Notifications panel. |
MX: 8.0+ Android API: 26+ |
||
2 | Hide | Hides the Gear icon in the Notifications panel. |
MX: 8.0+ Android API: 26+ |
Used to select the wallpaper image to be displayed on the device Home screen. If selecting a custom image, enter the file name and on-device path of the image using the Custom Home Wallpaper parameter.
Parm Name: HomeScreenWallpaper
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change device settings; any previously selected setting is retained. |
MX: 10.5+ |
||
1 | Restore to default | Returns the home-screen wallpaper to the default for Android devices. |
MX: 10.5+ |
||
2 | Custom | Allows selection of a user-defined image (.jpg or .png) file to be displayed on the device device Home screen. |
MX: 10.5+ |
Used to enter the file name and path on the device of an image file (.jpg
or .png
, 126 MB max.) for display on the device Home screen.
Parm value input rules:
.jpg
or .png
file formatsNote: Supported only on devices running Android 10 or later. Android 11 requires MX 11.3 or later.
Shown if: Set Home Screen Wallpaper is "Custom"
Parm Name: CustomHomeWallpaper
Requires:
- MX: 10.5+
Controls whether the device user can enable/disable the Large Key Indicator (LKI) pop-up, which is used to show active modifier keys. LKI features are supported on MC93 devices only.
Note: Supported on MC93 devices only.
Parm Name: SetLKI
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change on the device; any previously selected setting is retained. |
OSX: 8.1+ MX: 9.0+ |
||
1 | Turn On | Allows device user to change the LKI state. |
OSX: 8.1+ MX: 9.0+ |
||
2 | Turn Off | Prevents the device user from changing the LKI state. |
OSX: 8.1+ MX: 9.0+ |
This is the On/Off switch for the Large Key Indicator (LKI) pop-up, which is used to show active modifier keys. On most devices, the indicator is displayed in the Status Bar at the top of the screen. This parameter is accessible by the user only when SetLKI is set to "Turn On." LKI features are supported on MC93 devices only.
Note: Supported on MC93 devices only.
Parm Name: EnableLKI
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
OSX: 8.1+ MX: 9.0+ |
||
1 | Enable | Enables the Large Key Indicator (LKI) pop-up on the device. |
OSX: 8.1+ MX: 9.0+ |
||
2 | Disable | Disables the Large Key Indicator (LKI) pop-up on the device. |
OSX: 8.1+ MX: 9.0+ |
This is the On/Off switch for the Android Status bar on the device, which displays notifications and system icons. When disabled (option 2), the bar is not visible on the device and cannot be accessed by any means.
This feature is supported only on SDM660-platform devices, which includes (but is not limited to):
Note: Supported on SDM660-platform devices only.
Parm Name: StatusBarUsage
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
OSX: 8.1+ MX: 8.4+ Android API: 27+ |
||
1 | Enable | Enables the Android Status bar on the device. |
OSX: 8.1+ MX: 8.4+ Android API: 27+ |
||
2 | Disable | Disables the Android Status bar on the device. |
OSX: 8.1+ MX: 8.4+ Android API: 27+ |
This is the On/Off switch for on-screen power button that appears when long-pressing the physical power button on the device.
This feature is supported only on SDM660-platform devices, which includes (but is not limited to):
Note: Supported on SDM660-platform devices only.
Parm Name: OnScreenPowerButton
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
OSX: 8.1+ MX: 8.4+ Android API: 27+ |
||
1 | Enable | Enables the on-screen power button to turn off the device. |
OSX: 8.1+ MX: 8.4+ Android API: 27+ |
||
2 | Disable | Prevents the on-screen power button from turning off the device. |
OSX: 8.1+ MX: 8.4+ Android API: 27+ |
Used to select a digital assistant app as the default when an assistant app is used on the device.
Parm Name: AssistApp
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained. |
MX: 10.5+ |
||
1 | Google Digital Assistant | Selects the Google Digital Assistant app as the default when such an app is used. |
MX: 10.5+ |
||
2 | Custom assistant app | Allows a custom digital assistant app to be selected as the default when such an app is used. |
MX: 10.5+ |
||
3 | None | Disables digital assistant app functionality. |
MX: 10.5+ |
Used to enter the Android Package Name of a user-defined digital assistant app as the default when an assistant app is used on the device. Package Name must match that of an app already installed on the device.
Parm value input rules:
Example: com.google.android.apps.assistant
Note: Supported only on devices running Android 10 or later. Android 11 requires MX 11.3 or later.
Shown if: The Assistant App is "Custom"
Parm Name: CustomizeAssistApp
Requires:
- MX: 10.5+
Used to select whether to use black backgrounds for the Android System UI and compliant apps.
Parm Name: DarkTheme
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained. |
MX: 11.3+ |
||
1 | Turn On | Displays Dark Theme on apps that support it. |
MX: 11.3+ |
||
2 | Turn Off | Displays the default colors of all apps. |
MX: 11.3+ |
Used to select whether the device user can control the state (on/off) of Battery Saver through Settings, Quick Settings and Notification panels.
Parm Name: BatterySaver
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained. |
MX: 11.3+ |
||
1 | Enable | Allows the device user to control Battery Saver state (on/off). |
MX: 11.3+ |
||
2 | Disable | Prevents the device user from controlling Battery Saver state (on/off). |
MX: 11.3+ |
Used to select whether the device user can change the display and layout of Quick Settings tiles on the device.
Parm Name: QuickTileEdit
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained. |
MX: 11.3+ |
||
1 | Enable | Allows the device user to change the display and layout of Quick Settings tiles. |
MX: 11.3+ |
||
2 | Disable | Prevents the device user from changing the display and layout of Quick Settings tiles. |
MX: 11.3+ |
Used to select the action to show or hide Quick Settings tiles on the device.
Parm Name: QuickTileAction
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change | This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained. |
MX: 11.3+ |
||
1 | Show all | Displays all Quick Settings tiles on the device. |
MX: 11.3+ |
||
2 | Hide all | Hides all Quick Settings tiles on the device. |
MX: 11.3+ |
||
3 | Show individual | Adds the selected Quick Settings tile to the list of those shown on the device. |
MX: 11.3+ |
||
4 | Hide individual | Removes the selected Quick Settings tile from the list of those shown on the device. |
MX: 11.3+ |
||
5 | Reset to default | Restores the list of Quick Settings tiles displayed on the device to the System-default setting. |
MX: 11.3+ |
Used to select an individual Quick Settings tile to show or hide on the device.
Shown if: Quick Tile Action is "Show individual" or "Hide individual"
Parm Name: QuickTileIdentifier
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Airplane Mode |
MX: 11.3+ |
|||
1 | Auto-rotate |
MX: 11.3+ |
|||
2 | Battery Saver |
MX: 11.3+ |
|||
3 | Bedtime Mode |
MX: 11.3+ |
|||
4 | Bluetooth |
MX: 11.3+ |
|||
5 | Dark Theme |
MX: 11.3+ |
|||
6 | Data Saver |
MX: 11.3+ |
|||
7 | Do Not Disturb |
MX: 11.3+ |
|||
8 | Dump SysUI Heap |
MX: 11.3+ |
|||
9 | Flashlight |
MX: 11.3+ |
|||
10 | Focus Mode |
MX: 11.3+ |
|||
11 | Hotspot |
MX: 11.3+ |
|||
12 | Invert colors |
MX: 11.3+ |
|||
13 | Location |
MX: 11.3+ |
|||
14 | Mobile data |
MX: 11.3+ |
|||
15 | NFC |
MX: 11.3+ |
|||
16 | Nearby Share |
MX: 11.3+ |
|||
17 | Night Light |
MX: 11.3+ |
|||
18 | Screen Cast |
MX: 11.3+ |
|||
19 | Screen Record |
MX: 11.3+ |
|||
20 | Wi-Fi |
MX: 11.3+ |
|||
21 | Custom |
MX: 11.3+ |
Used to enter the name of the custom Quick Setting tile to show/hide on the device.
Parm value input rules:
Shown if: The Quick Tile Identifier is "Custom" and the Quick Tile Action is "Show individual" or "Hide individual"
Parm Name: QuickTileCustomIdentifier
Requires:
- MX: 10.5+
<wap-provisioningdoc>
<characteristic type="UiMgr" version="4.3" >
<parm name="CurrentLocale" value="en_GB"/>
<parm name="InputMethodAction" value="1"/>
<characteristic type="InputMethodDetails">
<parm name="InputMethodOption" value="1"/>
</characteristic>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="UiMgr" version="4.3" >
<parm name="InputMethodAction" value="1"/>
<characteristic type="InputMethodDetails">
<parm name="InputMethodOption" value="4"/>
<parm name="InputMethodPackageName" value="com.symbol.mxmf.csp.enterprisekeyboard"/>
<parm name="InputMethodClassName" value="com.android.inputmethod.latin.LatinIME"/>
</characteristic>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="UiMgr" version="4.3" >
<parm-query name="CurrentLocale"/>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="UiMgr" version="4.3" >
<parm name="CurrentLocale" value="en"/>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="UiMgr" version="4.3" >
<parm-query name="HomeKeyUsage"/>
</characteristic>
<wap-provisioningdoc>
<characteristic type="UiMgr" version="4.3" >
<parm name="HomeKeyUsage" value="1"/>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="UiMgr" version="4.3" >
<parm-query name="ClipboardUsage"/>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="UiMgr" version="4.3" >
<parm name="ClipboardUsage" value="1"/>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="UiMgr" version="4.3" >
<parm-query name="AutoCorrectUsage"/>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="UiMgr" version="4.3" >
<parm name="AutoCorrectUsage" value ="1"/>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="UiMgr" version="4.3" >
<parm-query name="BluetoothPairingPopupUsage"/>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="UiMgr" version="4.3" >
<parm name="BluetoothPairingPopupUsage" value="1"/>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="UiMgr" version="4.3" >
<characteristic-query type="InputMethodDetails"/>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="UiMgr" version="4.3" >
<parm name="InputMethodAction" value="1"/>
<characteristic-query type="InputMethodDetails">
<parm name="InputMethodOption" value="1"/>
</characteristic>
</characteristic>
<characteristic type="UiMgr" version="4.3" >
<parm name="InputMethodAction" value="1"/>
<characteristic type="InputMethodDetails">
<parm name="InputMethodOption" value="4"/>
<parm name="InputMethodPackageName" value="PackageName1"/>
<parm name="InputMethodClassName" value="ClassName1"/>
</characteristic>
</characteristic>
<wap-provisioningdoc>
<characteristic-query type="UiMgr"/>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="UiMgr" version="4.3" >
<parm name="CurrentLocale" value="en"/>
<parm name="HomeKeyUsage" value="1"/>
<parm name="ClipboardUsage" value ="1"/>
<parm name="AutoCorrectUsage" value ="1"/>
<parm name="InputMethodAction" value="1"/>
<parm name="BluetoothPairingPopupUsage" value="1"/>
<characteristic type="InputMethodDetails">
<parm name="InputMethodOption" value="4"/>
<parm name="InputMethodPackageName" value="PackageName1"/>
<parm name="InputMethodClassName" value="ClassName1"/>
</characteristic>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="UiMgr" version="7.1" >
<parm-query name="RecentAppButtonUsage" />
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="UiMgr" version="7.1" >
<parm name="RecentAppButtonUsage" value="1"/>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="UiMgr" version="7.1" >
<parm name="RecentAppButtonUsage" value="1"/>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="UiMgr">
<parm-query name="NavigationBarUsage"/>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="UiMgr" version="7.1" >
<parm name="RecentAppButtonUsage" value="1"/>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="UiMgr" version="8.0" >
<parm name="MagnificationGesture" value="2"/>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="UiMgr" version="8.0" >
<parm name="ShowVirtualKeyBoard" value="2"/>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="UiMgr" version="8.1" >
<parm name="SplitScreenMode" value="1"/>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="UiMgr" version="8.1" >
<parm name="SplitScreenMode" value="2"/>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic version="9.1" type="UiMgr">
<parm name="ShowPasswords" value="2" />
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic version="9.1" type="UiMgr">
<parm name="ShowPasswords" value="1" />
</characteristic>
</wap-provisioningdoc>