waybar-systemd-failed-units(5) File Formats Manual waybar-systemd-failed-units(5)

# [NAME](#NAME)

waybar - systemd failed units monitor module

# [DESCRIPTION](#DESCRIPTION)

The **systemd-failed-units** module displays the number of failed systemd units.

# [CONFIGURATION](#CONFIGURATION)

Addressed by **systemd-failed-units**

**format**:  
typeof: string  
default: **{nr\_failed} failed**  
The format, how information should be displayed. This format is used when other formats aren't specified.

**format-ok**:  
typeof: string  
This format is used when there is no failing units.

**user**:  
typeof: bool  
default: **true**  
Option to count user systemd units.

**system**:  
typeof: bool  
default: **true**  
Option to count systemwide (PID=1) systemd units.

**hide-on-ok**:  
typeof: bool  
default: **true**  
Option to hide this module when there is no failing units.

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

**{nr\_failed\_system}**: Number of failed units from systemwide (PID=1) systemd.

**{nr\_failed\_user}**: Number of failed units from user systemd.

**{nr\_failed}**: Number of total failed units.

**{systemd\_state}:** State of the systemd system session

**{user\_state}:** State of the systemd user session

**{overall\_state}:** Overall state of the systemd and user session. ("Ok" or "Degraded")

# [EXAMPLES](#EXAMPLES)

```
"systemd-failed-units": {
	"hide-on-ok": false,
	"format": "✗ {nr_failed}",
	"format-ok": "✓",
	"system": true,
	"user": false,
}
```

# [STYLE](#STYLE)

- **#systemd-failed-units**
- **#systemd-failed-units.ok**
- **#systemd-failed-units.degraded**

2026-10-16

---

Document: waybar-systemd-failed-units(5) from waybar 0.15.0-r0 (Chainguard OS)