Skip to content

[v3] SystemTray.SetLabel does not set the tooltip on Windows, contrary to docs #6045

Description

@Onatari

Wails version family

v3

Exact Wails version

v3.0.0-beta.8

Operating System

Windows

Description

The docs at https://v3.wails.io/features/menus/systray/#platform-specific-features
state that on Windows, SetLabel behaves the same as SetTooltip:

// Or use SetLabel (same as tooltip on Windows)
systray.SetLabel("My Application")

In practice, calling SetLabel does not set the hover tooltip on the tray icon.

To Reproduce

  1. Create a minimal Wails v3 app with a system tray
  2. Call systray.SetLabel("Test Label") only (no SetTooltip call)
  3. Hover over the tray icon in the Windows notification area

Expected behaviour

Hovering the tray icon shows "Test Label" as the tooltip.

Actual behavior
No tooltip appears / tooltip is empty.

Screenshots

No response

Attempted Fixes

No response

System Details

Wails v3.0.0-beta.8 › Wails Doctor
                                                                                                                                                                                                
# System
        
┌───────────────────────────────────────────────────────────────────┐
| Name              | Windows 10 Pro                                |
| Version           | 2009 (Build: 26200)                           |
| ID                | 25H2                                          |
| Branding          | Windows 11 Pro                                |
| Platform          | windows                                       |
| Architecture      | amd64                                         |
| Go WebView2Loader | true                                          |
| WebView2 Version  | 151.0.4129.107                                |
| CPU               | Intel(R) Core(TM) i7-9750H CPU @ 2.60GHz      |
| GPU               | Intel(R) UHD Graphics 630 (Intel Corporation) |
| Memory            | 16GB                                          |
└───────────────────────────────────────────────────────────────────┘
                   
# Build Environment
                   
┌──────────────────────────────────────────────────────────────────────┐
| Wails CLI      | v3.0.0-beta.8                                       |
| Go Version     | go1.26.5                                            |
| -buildmode     | exe                                                 |
| -compiler      | gc                                                  |
| CGO_ENABLED    | 0                                                   |
| DefaultGODEBUG | cryptocustomrand=1,tlssecpmlkem=0,urlstrictcolons=0 |
| GOAMD64        | v1                                                  |
| GOARCH         | amd64                                               |
| GOOS           | windows                                             |
└──────────────────────────────────────────────────────────────────────┘
              
# Dependencies
              
┌──────────────────────────────────────────────────────────────────────────────────────┐
| *Android NDK               | Not found. Install with: sdkmanager 'ndk;26.3.11579264' |
| *Android SDK               | D:\Programs\Android                                     |
| *Android platform-tools    | Installed                                               |
| *Java (Android)            | openjdk version "21.0.9" 2025-10-21 LTS                 |
| MSIX Packaging Tool        | Not Installed                                           |
| MakeAppx.exe (Windows SDK) | Not Installed                                           |
| NSIS                       | Not Installed                                           |
| SignTool.exe (Windows SDK) | Not Installed                                           |
| npm                        | 11.17.0                                                 |
| docker                     | *Not installed (optional - for cross-compilation)       |
|                                                                                      |
└────────────────────────────── * - Optional Dependency ───────────────────────────────┘
         
# Signing
         
┌────────────────────────────────────────┐
| macOS Signing   | Not configured       |
| Windows Signing | Not configured       |
| Linux Signing   | Not configured (GPG) |
└────────────────────────────────────────┘
                     
# Checking for issues
                     
 SUCCESS  No issues found
           
# Diagnosis
           
 SUCCESS  Your system is ready for Wails development

Additional context

Minimal repro code
package main

import (
_ "embed"
"github.com/wailsapp/wails/v3/pkg/application"
)

//go:embed assets/icon.png
var icon []byte

func main() {
app := application.New(application.Options{Name: "Tray Test"})
systray := app.SystemTray.New()
systray.SetIcon(icon)
systray.SetLabel("Test Label") // expected to show as tooltip per docs
app.Run()
}

Metadata

Metadata

Assignees

No one assigned

    Labels

    BugSomething isn't working

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions