Windows - Tray Notification - Set Titlebar Title

What the titlebar customization Worklet does

This Automox Worklet™ sets a custom titlebar title for the Automox agent tray window using the amagent notifications set_titlebar_title command. The titlebar displays your specified text in the tray notification area, allowing you to brand the agent interface with your organization name or a custom label.

The Worklet validates that the Automox Agent version 2.5 or higher is installed before applying the titlebar change. It enforces a maximum character limit of 20 characters for the titlebar text to maintain proper display in the tray window.

The Worklet validates that the Automox Agent version 2.5 or higher is installed before applying the titlebar change and enforces a maximum character limit of 20 characters for the titlebar text.

Why customize the agent tray titlebar

Users often become confused when they see unfamiliar tray icons on their endpoints. The default Automox tray appears as a generic third-party tool, which can lead to help desk tickets asking what the application is or whether it belongs to the organization. This creates unnecessary support burden.

Customizing the titlebar text reinforces your organization's branding and helps users identify the tray icon as belonging to your company. When users see your company name in the tray notification area, they understand that your organization is actively managing their endpoint. This transparency builds trust and helps users recognize legitimate Automox activities on their systems.

How titlebar customization works

1. Evaluation phase: The Worklet checks for the Automox agent tray executable (amagent-ui.exe) in the standard Program Files directories. It retrieves the installed Automox Agent version from the Windows registry and confirms that version 2.5 or higher is present before proceeding.

2. Remediation phase: The Worklet executes the amagent.exe command with the notifications set_titlebar_title argument, passing your custom text string. It validates that the title does not exceed 20 characters and is not empty before applying the change to the tray window.

Titlebar customization requirements

• Windows 10, Windows 11, or Windows Server 2016 or later

• Automox Agent version 2.5.0 or higher

• PowerShell 5.1 or later

• Amagent.exe executable available in the default Automox installation directory

• Custom titlebar text limited to a maximum of 20 characters

• RunNow capability enabled (FixNow compatible)

Expected agent tray branding state

After the Worklet runs successfully, the Automox agent tray window titlebar displays your custom text in the tray notification area. Users see your company name or custom label instead of the default title, creating a consistent branded experience across all managed endpoints. The change applies immediately with no endpoint restart required.

You can verify the change by clicking the Automox tray icon in the system taskbar. The notification window titlebar will display your custom text (up to 20 characters). Users will recognize the tray icon as part of your organization's endpoint management infrastructure, reducing confusion and support tickets.

How to validate set titlebar title changes

1. Run this Worklet on a pilot Windows endpoint and review evaluation output for set titlebar title.

2. Confirm Automox activity logs show successful completion and exit code 0.

3. Verify endpoint state using checks aligned to evaluation script logic, such as Test-Path, Get-ItemProperty, Where-Object.

4. Validate remediation effects from script operations such as Get-ItemProperty, Where-Object, Set-AmagentTitlebarTitle, then rerun evaluation for compliance.