Skip to main content
Version: 2.1

Master and Stack

The tile layout divides the workarea into a master area and a secondary area called the stack. This stack is a layout region, separate from visual stacking order.

The first master_count eligible clients occupy the master area. The rest occupy the secondary area. With the default settings, master is on the left and the secondary area is on the right. When there are no secondary clients, master fills the workarea.

Client order​

The layout uses visible, non-floating clients in client-list order. Mapping appends to that list. Rules, swaps and section helpers can rearrange it. Keyboard focus and raising do not determine the master client.

MethodEffect
c:to_primary_section()Move towards the front of the screen's client list
c:to_secondary_section()Move towards its end
c:swap(other)Exchange two client-list positions

The default Mod4 + Ctrl + Return binding swaps the target client with the first entry in awful.client.visible(c.screen). That list includes floating clients, so its first entry is not necessarily the first tiled client.

Tag properties​

PropertyDefaultEffect in tileDefault shortcut
master_count1Number of master clientsMod4+Shift+h adds one, Mod4+Shift+l removes one
master_width_factor0.5Master's share along the split axisMod4+l increases by 0.05, Mod4+h decreases
master_fill_policy"expand"Fill the workarea when the secondary area is empty. "master_width_factor" retains the splitNone
column_count1Columns in the secondary areaMod4+Ctrl+h adds one, Mod4+Ctrl+l removes one

Theme and tag settings can override these defaults. With four secondary clients, column_count = 2 makes two columns of two clients.

Which layouts use the split​

LayoutArrangement
tile / tile.rightMaster left, secondary area right
tile.leftMaster right, secondary area left
tile.bottomMaster top, secondary area bottom
tile.topMaster bottom, secondary area top
spiral, spiral.dwindleRepeated splits using master_width_factor, without a master-count region
magnifierFocused client enlarged over the others
fair, fair.horizontal, max, floatingNo master/secondary split
carousel, carousel.verticalScrollable columns with independent widths

Tasklist order​

The default tasklist uses client-list order, filtered to the clients it displays. Moving a client to the secondary section also moves it later in that tasklist. Custom tasklists can choose another order.

See client layouts for how layout rules become Clay declarations, or custom layouts to write your own.