Windows - Tray Notification - Customize Branding Icon

What the branding icon customization does

This Automox Worklet™ replaces the default Automox agent tray icon with your custom branded icon. The Worklet uses the amagent notifications set_icon command to apply custom PNG images to the system tray notification area.

You supply two icon files: one for dark mode display and one for light mode display. The Worklet automatically detects your system's current theme preference and applies the matching icon. Each icon must be 256 x 256 pixels in PNG format.

The Worklet requires Automox Agent version 2.5 or higher and verifies this requirement before applying the custom icon. If the Agent version is insufficient, the Worklet skips remediation.

Why customize your agent tray icon

Custom branding in the system tray reinforces your organization's identity to end users. When IT operations teams deploy Automox, the branded icon makes the agent feel like a native part of your corporate environment rather than third-party software.

This improves user trust in automated management processes. End users recognize your branded icon as a legitimate system component, which reduces support questions and increases acceptance of automated remediation actions. Consistent branding across your endpoint fleet also strengthens your IT operations visibility and control.

By deploying custom icons through Automox, you avoid manual configuration on individual endpoints. The Worklet runs at scale across your fleet, verifying every endpoint displays your approved branding immediately.

How branding icon customization works

1. Evaluation phase: The Worklet checks if the Automox Tray executable is installed at either Program Files (x86)\Automox or Program Files\Automox. It then retrieves the Automox Agent version from the Windows Registry and verifies the version meets the minimum requirement of 2.5.0.

2. Remediation phase: The Worklet validates that both the dark mode and light mode icon files are in PNG format. It then executes the amagent notifications set_icon command with the darkmode and lightmode file parameters, applying your custom icons to the system tray.

Branding icon customization requirements

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

• Automox Agent version 2.5 or higher

• Two PNG icon files, 256 x 256 pixels each (one for dark mode, one for light mode)

• PowerShell 5.1 or later

• RunNow capability enabled on your Automox workspace

Expected tray icon behavior

After successful remediation, your custom branded icon appears in the Windows system tray whenever the Automox Agent is running. The tray notification area automatically displays the light mode icon when your Windows theme is set to light mode and switches to the dark mode icon when dark mode is active.

Users see your custom branding on every endpoint where this Worklet has been applied. If you need to revert to the default Automox icon or change to different branded icons, deploy the Worklet again with new icon files. The Worklet provides no reset functionality because icon updates are managed through new deployments.

How to validate customize branding icon changes

1. Run this Worklet on a pilot Windows endpoint and review evaluation output for customize branding icon.

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