Customize Launcher Widgets

With Launcher 21.09 and later, you can customize custom attribute widgets and HTML widgets on the device homescreen which gives users a more intuitive and faster access to important apps, device information, or web pages.

Custom Attribute Widgets

Custom attributes widgets displays critical information for the end user such as the device ID, workflows, or support information. Custom attributes must include the following parameters in the XML:

• Displayed Title
• Icon Name
• Lookup value in UEM

Here are the available custom attribute widgets:

Device UUID

<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="ForYouWidgets" value="{&quot;ForYouWidgets&quot;: [
{&quot;label&quot;: &quot;Device UUID&quot;,&quot;type&quot;: &quot;lookupvalue&quot;,&quot;value&quot;: &quot;{DeviceUid}&quot;,&quot;icon&quot;: &quot;ic_communication_info&quot;} ]}"/>
</characteristic>

Group ID

<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec">
<parm name="ForYouWidgets" value="{&quot;ForYouWidgets&quot;: [{&quot;label&quot;: &quot;Group Identifier&quot;,&quot;type&quot;: &quot;lookupvalue&quot;,&quot;value&quot;: &quot;{GroupIdentifier}&quot;,&quot;icon&quot;: &quot;ic_media_folder&quot;}, {&quot;label&quot;: &quot;DeviceOperatingSystem&quot;,&quot;type&quot;: &quot;lookupvalue&quot;,&quot;value&quot;: &quot;{DeviceOperatingSystem}&quot;,&quot;icon&quot;: &quot;ic_media_tasklist&quot;}]}"/>
</characteristic>

HTML Widgets

HTML Widgets allow customers to either embed HTML code into Launcher or redirect the widget view to a hosted web URL. HTML custom XML must include the following parameters in:

• Displayed title
• Icon name
• Height in Px format
• Type ("0" for Minimized, "1" for Descriptive)

Here's the available HTML widgets:

Google HTML Page

<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4c1re9-qra041-e5a24acdb7ec">
<parm name="ForYouWidgets" value="{&quot;ForYouWidgets&quot;: [{&quot;label&quot;: &quot;Google&quot;,&quot;type&quot;: &quot;htmlwidget&quot;,&quot;value&quot;: &quot;https://www.google.com&quot;,&quot;icon&quot;: &quot;ic_media_tasklist&quot;,&quot;viewType&quot;: &quot;0&quot;}]}"/>
</characteristic>

Hub Support Intent

<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce932-a041-e5a24acdb7ec">
<parm name="ForYouWidgets" value="{&quot;ForYouWidgets&quot;: [{&quot;label&quot;: &quot;HUB&quot;,&quot;type&quot;: &quot;htmlwidget&quot;,&quot;value&quot;: &quot;https://mpaterno.github.io/&quot;,&quot;icon&quot;: &quot;ic_media_tasklist&quot;,&quot;viewType&quot;: &quot;1&quot;}]}"/>
</characteristic>

Intent to Open QR Code

<characteristic type="com.airwatch.android.androidwork.launcher" uuid="568bc89d-1df8-4ce9-a041-e5a24acdb7ec43">
<parm name="ForYouWidgets" value="{&quot;ForYouWidgets&quot;: [{&quot;label&quot;: &quot;intent&quot;,&quot;type&quot;: &quot;htmlwidget&quot;,&quot;value&quot;: &quot;PCFET0NUWVBFIGh0bWw+DQo8aHRtbD4NCjxib2R5Pg0KDQo8aDI+T1BFTiBRUiBDT0RFPC9oMj4NCjxwPiBQbGVhc2UgY2xpY2sgYmVsb3cgdG8gc2NhbiB0aGUgUVIgY29kZTwvcD4NCg0KICA8YSBocmVmPSJpbnRlbnQ6Ly9zY2FuLyNJbnRlbnQ7c2NoZW1lPXp4aW5nO3BhY2thZ2U9Y29tLmdvb2dsZS56eGluZy5jbGllbnQuYW5kcm9pZDtlbmQiPiBPcGVuIFFSIGNvZGU8L2E+DQoNCg0KPC9ib2R5Pg0KPC9odG1sPg0K&quot;,&quot;icon&quot;: &quot;ic_media_tasklist&quot;,&quot;viewType&quot;: &quot;1&quot;}]}"/>
</characteristic>

Clear App Data Widget

Admins can now add a Clear App Data widget to the Launcher Canvas providing end users with a fast, self-service way to reset app data without involving IT. This widget gives users confidence that their session data has been cleared before handing off to the next person especially valuable in shared-use environments. Designed for COSU, Shared, and Single App modes, it includes confirmation prompts and honors exclusion rules for safe and controlled usage.

 To configure the widget:

Widget Type: lookupvalue
Value: {clearAppData}

Once configured with the code above, add to the home screen.

Note: This widget/setting does not clear accounts

Logout Widget

Admins can now add a Logout widget to the Launcher home screen, giving shared device users a fast and familiar way to exit their current session. This is especially useful in check-in/check-out environments where users need to quickly end their session before handing the device to the next person.

When tapped, the widget logs the user out using the same behavior as the standard Launcher logout action. In Guest, Vendor, or Offline mode, the widget pushes or exits the user to the main login screen when configured.

To configure the widget:

Widget Type: lookupvalue
Value: {Logout}
Add Widget: Home screen

Once configured with the code above, add the widget to the home screen.

Note: This widget is intended for Launcher check-in/check-out workflows.

Available in Launcher 25.10 and above

Restart Device Widget

Admins can now add a Restart Device widget to Launcher, giving users a simple way to reboot their device directly from the home screen or For You page. This is especially useful for frontline and kiosk devices that may need periodic restarts to refresh configurations, recover from connectivity issues, or resolve app behavior without requiring users to navigate system menus or use hardware buttons.

The widget follows the same interaction model as other Launcher action widgets, providing a tappable tile or icon that starts the reboot action from within the Launcher experience.

To configure the widget:

Widget Type: lookupvalue
Value: {restart}
Add Widget: Home screen or For You

Once configured with the code above, add the widget to the home screen or For You page.

Note: Restart behavior may depend on the device model, Android version, and management permissions available on the device.

Available in Launcher 26.03 and above