Windows - Tray Notification - Set Tooltip Text

What the tray tooltip Worklet does

This Automox Worklet™ sets custom tooltip text for the Automox agent tray icon using the amagent notifications set_tray_tooltip command. The tooltip displays when users hover over the tray icon in the Windows notification area, allowing you to customize the message with your organization name, a status indicator, or instructional text.

The Worklet validates that the Automox Agent version 2.5 or higher is installed before applying the tooltip change. It checks for the amagent-ui.exe executable in the standard Program Files directories and confirms the agent version meets the minimum requirement before proceeding with the tooltip configuration.

Why customize the agent tray tooltip

The tray tooltip is the first piece of information users see when they hover over the Automox agent icon. Customizing this text allows you to reinforce your organization's branding and provide users with context about the agent. Instead of the default 'Automox' message, you can display your company name, department name, or a helpful instruction like 'IT Management Agent.'

Custom tooltips improve user experience by clearly identifying the tray icon as belonging to your organization. Users understand that the agent is an approved IT tool managed by your company, not an unknown third-party application. This transparency reduces user confusion, builds trust in your endpoint management processes, and helps prevent false security concerns about the tray icon.

How tray tooltip configuration works

1. Evaluation phase: The Worklet checks for the Automox agent tray executable (amagent-ui.exe) in the Program Files (x86) directory first, then checks the standard Program Files directory if not found. It retrieves the installed Automox Agent version from the Windows registry and verifies that version 2.5.0 or higher is present before proceeding with remediation.

2. Remediation phase: The Worklet executes the amagent.exe command with the notifications set_tray_tooltip argument, passing your custom tooltip text string. It validates that the tooltip text is not empty before applying the change. The amagent command updates the tray icon tooltip to display your custom text when users hover over the agent icon in the notification area.

Tray tooltip configuration 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 tooltip text must not be empty

• RunNow capability enabled (FixNow compatible)

Expected tray notification state

After the Worklet runs successfully, users see your custom tooltip text when they hover over the Automox agent tray icon in the Windows notification area. The tooltip now displays your organization name, department identifier, or custom message instead of the default 'Automox' text, creating a consistent branded experience across all managed endpoints.

The change applies immediately after the Worklet completes with no endpoint restart required. You can verify the change by hovering over the Automox tray icon in the system notification area (bottom right of the taskbar) and confirming that your custom tooltip text appears. The tooltip change persists across endpoint restarts and remains in place until you apply a different tooltip configuration.

How to validate set tooltip text changes

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

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-AmagentTooltip, then rerun evaluation for compliance.