waybar-tray(5) File Formats Manual waybar-tray(5)

# [NAME](#NAME)

waybar - tray module

# [DESCRIPTION](#DESCRIPTION)

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

# [CONFIGURATION](#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](#EXAMPLES)

```
"tray": {
	"icon-size": 21,
	"spacing": 10,


  "icons": {


    "blueman": "bluetooth",


    "TelegramDesktop": "$HOME/.local/share/icons/hicolor/16x16/apps/telegram.png"


  }
}
```

# [STYLE](#STYLE)

- **#tray**
- **#tray > .passive**
- **#tray > .active**
- **#tray > .needs-attention**

2026-10-30

---

Document: waybar-tray(5) from waybar 0.15.0-r2 (Chainguard OS)