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
- Create a minimal Wails v3 app with a system tray
- Call systray.SetLabel("Test Label") only (no SetTooltip call)
- 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()
}
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:
In practice, calling SetLabel does not set the hover tooltip on the tray icon.
To Reproduce
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 developmentAdditional 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()
}