Clear the red config-error bar pinned across every screen
Checked against Hyprland v0.56.2 source (hyprwm/Hyprland), against the live wiki page the record already cites, and live on this Omarchy 4 workstation (hyprland 0.56.2-1, omarchy 4.0.2-1). The three options are real and the record's semantics held: src/errorOverlay/Overlay.cpp reads debug:error_limit and debug:error_position and sets const bool TOPBAR = *BAR_POSITION == 0;, so 0 is top and 1 is bottom as the record says, and https://wiki.hypr.land/Configuring/Basics/Variables/ documents error_position default 0, error_limit default 5 and suppress_errors default false. That last one is the first defect: the record tells the reader to cap the bar at error_limit = 5, which is already the default, confirmed live here with hyprctl getoption debug:error_limit returning int: 5 set: false, so the advice as written changes nothing. The second defect is the hyprctl seterror disable framing. It is not limited to a bar set by a script: dispatchSeterror in src/debug/HyprCtl.cpp calls ErrorOverlay::overlay()->destroy() for any invocation with fewer than three arguments, so it clears the parser's bar too, and the wiki's Using-hyprctl page says the error string "will reset when Hyprland's config is reloaded". So the honest answer is that the bar can be dismissed without fixing the config, but only until the next reload, and I rewrote the fix to say that rather than leaving the folklore in place. The third defect is the cause: "the offending lines are just ignored" is true of a hyprlang parse error but not of Lua, where an error stops the file, and on 0.56.2 a file that stops before registering any bind also trips emergency mode, which the record's sibling covers. I also labelled the hyprlang block as plain Arch and said where the Lua goes on Omarchy 4, ~/.config/hypr/looknfeel.lua, after reading /usr/share/omarchy/config/hypr/hyprland.lua to confirm the module load order. Checked whether the edit is transient: /usr/share/omarchy/bin/omarchy-update never calls omarchy-refresh-hyprland, and the migrations under /usr/share/omarchy/migrations/ patch hyprland.lua surgically, so the edit survives omarchy update and is only lost if the reader runs omarchy-refresh-hyprland themselves. Cited issue 5758 was read in full: it is real and closed on 2026-05-12, and it supports the symptom and the non-fatal hyprlang behaviour, but it is Omarchy 3.8 on Hyprland 0.55 with .conf files under ~/.local/share/omarchy, so it does not carry the Omarchy 4 Lua specifics on its own. Its basecamp URL 404s for an anonymous fetch after the rename, so it is replaced by the omacom one. NOT exercised: I did not run hyprctl seterror, hyprctl keyword or hyprctl reload on this workstation, and I did not induce a config error, so the dismissal behaviour is confirmed from the v0.56.2 source and the wiki rather than by triggering the bar.
suppress_errors = true hides genuinely broken config from you later, including the emergency mode banner that tells you no keybindings were registered. hyprctl seterror disable clears the bar only until the next config reload, so it is easy to mistake for a fix when the config is still broken.
Symptom
A red config-error bar is pinned across the top of every screen, over the browser and everything else, and stays there. Users describe it as 'IN YOUR FACE' and unusable.
Cause
Hyprland draws config errors in an overlay bar, src/errorOverlay/Overlay.cpp, re-queued on every config reload and rendered on every monitor. It reserves screen space on the focused monitor, so windows there are pushed down or up rather than covered, while on any other monitor it sits on top of whatever is below it. What happens to the rest of the config depends on the syntax. A hyprlang parse error skips the offending line and the rest of the file still loads, which is the "non-fatal" behaviour most advice describes. A Lua error stops execution at that point, so nothing later in the file runs, and if that leaves zero keybinds registered Hyprland 0.56.2 also trips emergency mode. The bar's position and the number of lines it shows are configurable through debug:error_position and debug:error_limit, and debug:suppress_errors stops it being drawn at all.
Fix
Read the errors first, because everything below only changes how they are shown:
hyprctl configerrors
Move the bar to the bottom. On Omarchy 4 put this in ~/.config/hypr/looknfeel.lua, which is loaded after the Omarchy defaults:
hl.config({ debug = { error_position = 1 } }) -- 0 = top, 1 = bottom
debug:error_limit already defaults to 5 and accepts 0 to 20, so setting it to 5 changes nothing. Lower it only if five lines is still too many:
hl.config({ debug = { error_position = 1, error_limit = 2 } })
On plain Arch with a hyprlang ~/.config/hypr/hyprland.conf, the equivalent is:
debug {
error_position = 1
error_limit = 2
}
Omarchy 4 ships no hyprland.conf. Its Hyprland config is ~/.config/hypr/hyprland.lua plus the hypr/*.lua modules it requires, so use the Lua form there.
Drop the bar right now without editing anything:
hyprctl seterror disable
That destroys the overlay whatever put it there, the config parser included, not only a bar set by a script. It is temporary: the next config reload draws it again.
Suppress it for good, once you know what the errors are:
hl.config({ debug = { suppress_errors = true } })
Neither of those fixes the config, and the errors are still listed by hyprctl configerrors. If the bar is the only thing telling you the config is broken, the real fix is the config.
omarchy update does not overwrite ~/.config/hypr/*.lua, so an edit there survives updates. omarchy-refresh-hyprland does overwrite them with the Omarchy defaults, so re-apply the setting if you ever run it.
Verify
hyprctl configerrors prints nothing once the config parses cleanly. After hyprctl reload the bar is gone, or sits at the bottom if you moved it. Confirm the settings took with hyprctl getoption debug:error_position and hyprctl getoption debug:error_limit.
Sources
- https://wiki.hypr.land/Configuring/Basics/Variables/
- https://wiki.hypr.land/Configuring/Advanced-and-Cool/Using-hyprctl/
- https://github.com/omacom/omarchy/issues/5758
- https://github.com/hyprwm/Hyprland/blob/v0.56.2/src/errorOverlay/Overlay.cpp
- https://github.com/hyprwm/Hyprland/blob/v0.56.2/src/debug/HyprCtl.cpp