window rules targeting xdgTag aren't honored

[luna-system]

when using recent versions of Proton GE, one can enable PROTON_ENABLE_WAYLAND=1 which does a few things, but the most relevant thing is that it adds an xdgTag of proton-game. it also changes how the window class is handled, so rather than steam_app_<id> you would just have something like game.exe. having window rules that target class:^steam_app_ is how many of us manage all steam games at once with a single window rule. however using PROTON_ENABLE_WAYLAND is necessary for some features (like HDR in Warframe), so we'll want to write rules against the xdgTag to cover the gap. that said - this doesn't seem to work atm. a rule targeting the correct window class works fine, but changing it to target the xdgTag causes the rule to be either ignored or otherwise misfired.

hyprctl clients has our example client as:

Window 55c0a4d44ec0 -> Warframe:
        mapped: 1
        hidden: 0
        at: 1207,839
        size: 1026,642
        workspace: 6 (games)
        floating: 1
        pseudo: 0
        monitor: 0
        class: launcher.exe
        title: Warframe
        initialClass: launcher.exe
        initialTitle: Warframe
        pid: 43178
        xwayland: 0
        pinned: 0
        fullscreen: 0
        fullscreenClient: 0
        grouped: 0
        tags: game*
        swallowing: 0
        focusHistoryID: 2
        inhibitingIdle: 0
        xdgTag: proton-game
        xdgDescription: This is a game running through proton

and our window rule looks like:
windowrule = workspace 6, xdgtag:proton-game

which doesn't work, the game opens on the focused workspace instead.

interestingly, if you do windowrule = tag +game, xdgtag:proton-game, then a window rule moving windows with the game tag to another workspace will work, so that's the workaround we're going with for now.

and finally:

➜ hyprctl version
Hyprland 0.51.1 built from branch  at commit 71a1216abcc7031776630a6d88f105605c4dc1c9  ([gha] Nix: update inputs).
Date: Mon Sep 22 20:54:03 2025
Tag: v0.51.1, commits: 6436
built against:
 aquamarine 0.9.5
 hyprlang 0.6.3
 hyprutils 0.10.0
 hyprcursor 0.1.13
 hyprgraphics 0.2.0


no flags were set

note that #11977 is tangentially relevant as it mentions using PROTON_ENABLE_WAYLAND to explicitly have the xdgTag to write window rules against

also note that https://www.reddit.com/r/hyprland/comments/1o8qed6/how_do_i_use_xdgtag_with_windowrules/ is almost certainly related to this report :)

[Zebra2711]

try

windowrule = workspace 6,class:.*, xdgtag:proton-game

[Dregu]

Actually the rules turned case sensitive in some update (accidentally?) and this one is documented wrong on top of that; windowrule = workspace 6, xdgTag:proton-game works fine for me on -git, lowercase does not.

[vaxerski]

oopes, @luna-system can you check xdgTag?

[K1NGSSTH]

So i try all that before, xdgTag instead of xdgtag, tried to add into a tag, tried to add class, tittle in front of it, but it doesn't work at all in my end, i don't use git hirpland so maybe it could be that? I also use xdg-portal-hyprland instead of the wlr, maybe that also has something to do with it?

Hyprland 0.51.1 built from branch  at commit 71a1216abcc7031776630a6d88f105605c4dc1c9  ([gha] Nix: update inputs).
Date: Mon Sep 22 20:54:03 2025
Tag: v0.51.1, commits: 6436
built against:
 aquamarine 0.9.5
 hyprlang 0.6.3
 hyprutils 0.10.0
 hyprcursor 0.1.13
 hyprgraphics 0.2.0


no flags were set

[luna-system]

xdg-portals don't relate to this at all so don't worry about that. we are using the same version and custom tagging the xdgtag works for us.

[K1NGSSTH]

Then i have no clue why doesn't work for me, tried everything and it just refused to work unfortunately.

[K1NGSSTH]

I want to update this post in case someone in the future comes across it, after updating to Hyprland version 0.52 now the xdgTag is working without any issues for me!