Tray Customization Worklets

This document provides guidance for using Automox Worklets™ to customize aspects of the Automox Tray experience on user devices. These worklets allow administrators to configure functionality beyond what is available in policy settings, such as defining a persistent message or enabling or disabling the tray interface. Additional customization worklets will be introduced in future agent releases.

View Tray Management Worklets in the Worklet Catalog

Prerequisites:
  • Your Automox plan must include worklets to access the worklet catalog.
  • If your plan does not include access to the worklet catalog, you can manually create a worklet using the corresponding script provided for each item in this document.
  • You must have the required permissions to create or manage worklets in your organization.

Customize Trusted Message

This section describes two worklets that allow you to customize the message displayed at the bottom of the Automox Tray notification window. This static message helps users recognize that the notification is provided by an authorized IT administrator or service provider and is safe to act on. These worklets are available for both Windows and macOS.

The message supports up to two lines of text (approximately 75 characters total). Text beyond this limit will be cut off. This configuration is not controlled through policy settings and must be applied using a worklet.

View in Worklet Catalog:

Remove Custom Trusted Message

To remove an applied custom message, update the text in the worklet or apply a new worklet with empty text to reset to the default messaging.

Enable or Disable the Automox Tray

This section includes two worklets that let administrators enable or disable the Automox tray on supported Windows devices. Disabling the tray prevents it from displaying to users, while enabling it restores its visibility. These settings are applied locally through the presence or absence of a control file and are not managed through policy.

View in Worklet Catalog:

Customize Tray Branding Icon

This section describes a new worklet that allows you to customize the system icon displayed on an endpoint. This icon, shown in the Menu Bar on macOS and in Window’s System Tray allows users to launch the Agent Tray. This customization helps deliver a more intuitive, professional, and tailored experience to end users.

Icon Requirements

  • Device must be running Agent v2.5.x or higher
  • File Type(s) Supported: Only .png is supported at this time
  • File Size (Pixels) Supported: Files must be 256 x 256 pixels
  • Both a Light Mode and Dark Mode file are required, with the following naming conventions; lightModeIcon.png, darkModeIcon.png respectively.
    • Note: On macOS, the tray icon updates automatically with OS theme changes. On Windows, the icon updates after an Agent restart or with certain Agent activity.

View in Worklet Catalog:

Customize Icon Tooltip (Windows Only)

This section describes a new worklet that allows you to customize the tooltip string that is displayed when hovering over the Agent icon in the Windows system tray. This enhancement is supported on Windows only at this time.

Tooltip Requirements

  • Endpoint must be running Agent v2.5.x or higher
  • Custom tooltip text must be 75 characters or less
  • Field supports UTF-8 character encoding

View in Worklet Catalog:


Customize Tray Title (Windows Only)

This section describes a new worklet that allows you to customize the title string in the Tray. This enhancement is supported on Windows only at this time.

Title Requirements

  • Device must be running Agent v2.5.x or higher
  • Custom title text must be 20 characters or less
  • Field supports UTF-8 character encoding

View in Worklet Catalog:

Related Topics