waybar-tray(5)

waybar-tray5

Tray module

Overview

WARNING tray is still in beta. There may be bugs. Breaking changes may occur.

Configuration

Addressed by tray

icon-size:
typeof: integer
Defines the size of the tray icons.

show-passive-items:
typeof: bool
default: false
Defines visibility of the tray icons with Passive status.

smooth-scrolling-threshold:
typeof: double
Threshold to be used when scrolling.

spacing:
typeof: integer
Defines the spacing between the tray icons.

reverse-direction:
typeof: bool
Defines if new app icons should be added in a reverse order

on-update:
typeof: string
Command to execute when the module is updated.

expand:
typeof: bool
default: false
Enables this module to consume all left over space dynamically.

Examples

"tray": {
	"icon-size": 21,
	"spacing": 10,
  "icons": {
    "blueman": "bluetooth",
    "TelegramDesktop": "$HOME/.local/share/icons/hicolor/16x16/apps/telegram.png"
  }
}

Style

•

#tray

•

#tray > .passive

•

#tray > .active

•

#tray > .needs-attention

Releases

4 releases since Debian 11 (Bullseye); the text changed 3 times.

  1. 11
  2. 12
  3. 13
  4. Arch

From waybar 0.15.0-3 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.