waybar-sway-scratchpad(5) File Formats Manual waybar-sway-scratchpad(5)

# [NAME](#NAME)

waybar - sway scratchpad module

# [DESCRIPTION](#DESCRIPTION)

The **scratchpad** module displays the scratchpad status in Sway

# [CONFIGURATION](#CONFIGURATION)

Addressed by **sway/scratchpad**

**format**:  
typeof: string  
default: {icon} {count}  
The format, how information should be displayed.

**show-empty**:  
typeof: bool  
default: false  
Option to show module when scratchpad is empty.

**format-icons**:  
typeof: array/object  
Based on the current scratchpad window counts, the corresponding icon gets selected.

**tooltip**:  
typeof: bool  
default: true  
Option to disable tooltip on hover.

**tooltip-format**:  
typeof: string  
default: {app}: {title}  
The format, how information in the tooltip should be displayed.

**menu**:  
typeof: string  
Action that popups the menu.

**menu-file**:  
typeof: string  
Location of the menu descriptor file. There need to be an element of type

GtkMenu with id **menu**

**menu-actions**:  
typeof: array  
The actions corresponding to the buttons of the menu.

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

# [FORMAT REPLACEMENTS](#FORMAT_REPLACEMENTS)

**{icon}**: Icon, as defined in **format-icons**.

**{count}**: Number of windows in the scratchpad.

**{app}**: Name of the application in the scratchpad.

**{title}**: Title of the application in the scratchpad.

# [EXAMPLES](#EXAMPLES)

```
"sway/scratchpad": {
	"format": "{icon} {count}",
	"show-empty": false,
	"format-icons": ["", ""],
	"tooltip": true,
	"tooltip-format": "{app}: {title}"
}
```

# [STYLE](#STYLE)

- **#scratchpad**
- **#scratchpad.empty**

2026-10-16

---

Document: waybar-sway-scratchpad(5) from waybar 0.15.0-r0 (Chainguard OS)