title | description | author | ms.author | ms.date | ms.topic |
---|---|---|---|---|---|
Windows Terminal Appearance Settings |
Learn how to customize appearance settings within Windows Terminal. |
cinnamon-msft |
cinnamon |
07/06/2022 |
how-to |
The properties listed below affect the entire terminal window, regardless of the profile settings. These should be placed at the root of your settings.json file.
This sets an override for the application's preferred language.
Property name: language
Necessity: Optional
Accepts: A BCP-47 language tag like "en-US"
:::row:::
:::column span="":::
This sets the theme of the application. "system"
will use the same theme as Windows.
Property name: theme
Necessity: Optional
Accepts: "system"
, "dark"
, "light"
Default value: "system"
:::column-end::: :::column span=""::: Configuration: Powerline in PowerShell
:::column-end::: :::row-end:::
:::row:::
:::column span="":::
When this is set to true
, tabs are always displayed. When it's set to false
and showTabsInTitlebar
is set to false
, tabs are always displayed underneath the title bar. When this is set to false
and showTabsInTitlebar
is set to false
, tabs only appear after more than one tab exists, by typing ctrl+shift+t or by typing the key binding assigned to newTab
. Note that changing this setting will require starting a new terminal instance.
Note
This setting has no effect when showTabsInTitlebar
is true
.
Property name: alwaysShowTabs
Necessity: Optional
Accepts: true
, false
Default value: true
:::column-end::: :::column span="":::
:::column-end::: :::row-end:::
:::row:::
:::column span="":::
When this is set to true
, the tabs are moved into the title bar and the title bar disappears. When it's set to false
, the title bar sits above the tabs. Note that changing this setting will require starting a new terminal instance.
Property name: showTabsInTitlebar
Necessity: Optional
Accepts: true
, false
Default value: true
:::column-end::: :::column span="":::
:::column-end::: :::row-end:::
:::row:::
:::column span="":::
When this is set to true
, the tab row is given an acrylic background at 50% opacity. When it's set to false
, the tab row will be opaque. Note that changing this setting will require starting a new terminal instance.
Property name: useAcrylicInTabRow
Necessity: Optional
Accepts: true
, false
Default value: false
:::column-end::: :::column span="":::
:::column-end::: :::row-end:::
When this is set to true
, the title bar displays the title of the selected tab. When it's set to false
, title bar displays "Windows Terminal". Note that changing this setting will require starting a new terminal instance.
Property name: showTerminalTitleInTitlebar
Necessity: Optional
Accepts: true
, false
Default value: true
When set to true, Windows Terminal windows will launch on top of all other windows on the desktop. This state can also be toggled with the toggleAlwaysOnTop
key binding.
Property name: alwaysOnTop
Necessity: Optional
Accepts: true, false
Default value: false
:::row:::
:::column span="":::
This sets the width of the tabs. "equal"
makes each tab the same width. "titleLength"
sizes each tab to the length of its title. "compact"
will shrink every inactive tab to the width of the icon, leaving the active tab more space to display its full title.
Property name: tabWidthMode
Necessity: Optional
Accepts: "equal"
, "titleLength"
, "compact"
Default value: "equal"
:::column-end::: :::column span="":::
:::column-end::: :::row-end:::
This disables visual animations across the application when set to true
.
Property name: disableAnimations
Necessity: Optional
Accepts: true
, false
Default value: false
:::row:::
:::column span="":::
When this is set to true
, closing a window with multiple tabs open will require confirmation. When it's set to false
, closing a window with multiple tabs open will not require confirmation.
Property name: confirmCloseAllTabs
Necessity: Optional
Accepts: true
, false
Default value: true
:::column-end::: :::column span="":::
:::column-end::: :::row-end:::
When set to true
, the background image for the currently focused profile is expanded to encompass the entire window, beneath other panes. This is an experimental feature, and its continued existence is not guaranteed.
Property name: experimental.useBackgroundImageForWindow
Necessity: Optional
Accepts: true
, false
Default value: false