---
name: "waybar-systemd-failed-units"
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-systemd-failed-units"
---

# waybar-systemd-failed-units(5)

systemd failed units monitor module

## NAME

waybar - systemd failed units monitor module

## DESCRIPTION

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

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

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

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

## STYLE

- •

  **#systemd-failed-units**

- •

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

- •

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