Hyprland Wiki
Contribute to the Wiki! Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

Master Layout

The master layout makes one (or more) window(s) be the “master”, taking (by default) the left part of the screen, and tiles the rest on the right. You can change the orientation on per-workspace basis if you want to use anything other than the default left/right split.

master1

Config

category name master

name description type default
special_scale_factor (0.0 - 1.0) the scale of the special workspace windows float 0.8
new_is_master whether a newly open window should replace the master or join the slaves. bool true
new_on_top whether a newly open window should be on the top of the stack bool false
no_gaps_when_only whether to apply gaps when there is only one window on a workspace, aka. smart gaps. bool false
orientation default placement of the master area, can be left, right, top or bottom string left
inherit_fullscreen inherit fullscreen status when cycling/swapping to another window (e.g. monocle layout) bool true

Dispatchers

layoutmsg params:

param description
swapwithmaster swaps the current window with master. If the current window is the master, swaps it with the first child.
focusmaster focuses the master window. If the current window is the master, focuses the first child.
cyclenext focuses the next window respecting the layout
cycleprev focuses the previous window respecting the layout
swapnext swaps the focused window with the next window respecting the layout
swapprev swaps the focused window with the previous window respecting the layout
addmaster adds a master to the master side. That will be the active window, if it’s not a master, or the first non-master window.
removemaster removes a master from the master side. That will be the active window, if it’s a master, or the last master window.
orientationleft sets the orientation for the current workspace to left (master area left, slave windows to the right, vertically stacked)
orientationright sets the orientation for the current workspace to right (master area right, slave windows to the left, vertically stacked)
orientationtop sets the orientation for the current workspace to top (master area top, slave windows to the bottom, horizontally stacked)
orientationbottom sets the orientation for the current workspace to bottom (master area bottom, slave windows to the top, horizontally stacked)
orientationnext cycle to the next orientation for the current workspace (clockwise)
orientationprev cycle to the previous orientation for the current workspace (counter-clockwise)

example usage:

bind=MOD,KEY,layoutmsg,cyclenext