Skip to content

window_decorations = "TITLE | RESIZE"

Since: Version 20210314-114017-04b7cedd

The functionality 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 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 RESIZE instead of NONE if 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 functionality 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 1.0.

Since: Version 20230408-112425-69ae8472

The functionality described in this section requires version 20230408-112425-69ae8472 of wezterm, or a more recent version.

  • window_decorations = "INTEGRATED_BUTTONS|RESIZE" - place window management buttons (minimize, maximize, close) into the tab bar instead of showing a title bar.

See also integrated_title_button_style, integrated_title_buttons, integrated_title_button_alignment integrated_title_button_color and, if you are using the retro tab bar, tab_bar_style.

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.

Warning

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 RESIZE enabled.

Danger

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 decorations.

Tip

You probably always want RESIZE to be listed in your window_decorations.