---
name: "waybar-tray"
section: "5"
platform: "linux"
package: "waybar"
version: "0.15.0-3"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/waybar-tray"
---

# waybar-tray(5)

tray module

## NAME

waybar - tray module

## DESCRIPTION

*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**