window_decorations = "TITLE | RESIZE"¶
Since: Version 20210314-114017-04b7cedd
The feature described in this section requires version 20210314-114017-04b7cedd of wezterm, or a more recent version.
Configures whether the window has a title bar and/or resizable border.
The value is a set of of flags:
window_decorations = "NONE"- disables titlebar and border (borderless mode), but causes problems with resizing and minimizing the window, so you probably want to use
NONEif you just want to remove the title bar.
window_decorations = "TITLE"- disable the resizable border and enable only the title bar
window_decorations = "RESIZE"- disable the title bar but enable the resizable border
window_decorations = "TITLE | RESIZE"- Enable titlebar and border. This is the default.
Since: Version 20230320-124340-559cb7b0
The feature described in this section requires version 20230320-124340-559cb7b0 of wezterm, or a more recent version.
The following flags are also supported on macOS:
MACOS_FORCE_DISABLE_SHADOW- disable the window shadow effect
MACOS_FORCE_ENABLE_SHADOW- enable the window shadow effect.
The window shadow effect is normally disabled by wezterm when the
window_background_opacity is set
to less than
On X11 and Wayland, the windowing system may override the window decorations.
When the titlebar is disabled you can drag the window using the tab bar if it
is enabled, or by holding down
SUPER and dragging the window (on Windows:
CTRL-SHIFT and drag the window). You can map this dragging function for
yourself via the StartWindowDrag key
assignment. Note that if the pane is running an application that has enabled
mouse reporting you will need to hold down the
SHIFT modifier in order for
StartWindowDrag to be recognized.
When the resizable border is disabled you will need to use features of your desktop environment to resize the window. Windows users may wish to consider AltSnap.
Think twice before removing
RESIZE from the set of decorations as it causes
problems with resizing and minimizing the window. You usually want to keep
If you just want to remove the title bar, set
window_decorations = "RESIZE"
as you will run into problems if you remove
RESIZE from the set of
You probably always want
RESIZE to be listed in your