The properties listed below affect the entire terminal window, regardless of the profile settings. These should be placed at the root of yoursettings.json file.

Language

This sets an override for the application's preferred language.

Property name:language

Necessity: Optional

Accepts: A BCP-47 language tag like"en-US"

Theme

This sets the theme (dark theme or light theme) of the application."system" will use the same theme as Windows.

Property name:theme

Necessity: Optional

Accepts:"system","dark","light", name of customtheme

Default value:"system"

Always show tabs

Show tabs in fullscreen

When this is set totrue, tabs remain visible in fullscreen mode. When it's set tofalse, tabs will be hidden when entering fullscreen mode.

Property name:showTabsFullscreen

Necessity: Optional

Accepts:true,false

Default value:false

Position of newly created tabs (Preview)

Specifies where new tabs appear in the tab row. When this is set to"afterLastTab", new tabs appear at the end of the tab row. When it's set to"afterCurrentTab", new tabs appear after the current tab.

Property name:newTabPosition

Necessity: Optional

Accepts:"afterLastTab","afterCurrentTab"

Default value:"afterLastTab"

Hide the title bar

Show acrylic in tab row

Use active terminal title as application title

When this is set totrue, the title bar displays the title of the selected tab. When it's set tofalse, 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

Always on top mode

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 thetoggleAlwaysOnTop key binding.

Property name:alwaysOnTop

Necessity: Optional

Accepts:true, false

Default value:false

Tab width mode

Disable pane animations

This disables visual animations across the application when set totrue.

Property name:disableAnimations

Necessity: Optional

Accepts:true,false

Default value:false

Show close all tabs popup

Use a background image for the entire window

When set totrue, 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

New tab dropdown

This setting enables you to configure the list of profiles and the structure of the new tab dropdown menu. This lets you reorder profiles, nest profiles into sub-menus, hide profiles and more. ThenewTabMenu setting accepts a list of "New tab menu entries", which are described below.

An example of this setting might look like:

{    "newTabMenu": [        { "type":"profile", "profile": "Command Prompt" },        { "type":"profile", "profile": "Windows PowerShell", "icon": "C:\\path\\to\\icon.png" },        { "type":"separator" },        {            "type":"folder",            "name": "ssh",            "icon": "C:\\path\\to\\icon.png",            "entries":            [                { "type":"profile", "profile": "Host 1" },                { "type":"profile", "profile": "8.8.8.8" },                { "type":"profile", "profile": "Host 2" }            ]        },        {            "type": "folder",            "name": "WSL",            "entries": [ { "type": "matchProfiles", "source": "Microsoft.Terminal.Wsl" } ]        },        { "type": "remainingProfiles" }    ]}

Property name:newTabMenu

Necessity: Optional

Accepts: a list of new tab menu entries

Default value:[ { "type":"remainingProfiles" } ]

New tab menu entries

The following are different types of new tab menu entries that can be used in thenewTabMenu setting. They are each in the form of a JSON object with atype property and other properties specific to that entry type. The values for thetype property are listed below.

• profile
• folder
• separator
• matchProfiles
• remainingProfiles
• action

Profile

This entry type represents a profile from your list of profiles. The profile can be specified by name or GUID.

{ "type":"profile", "profile": "Command Prompt" }

Parameters

Folder

This entry type represents a nested folder in the new tab dropdown menu. Folders can be nested inside of other folders.

{    "type":"folder",    "name": "ssh",    "icon": "C:\\path\\to\\icon.png",    "entries":    [        { "type":"profile", "profile": "Host 1" },        { "type":"profile", "profile": "Host 2" }    ]}

Parameters

Separator

This entry type represents a separator in the new tab dropdown menu.

{ "type":"separator" }

Remaining Profiles

This entry type represents all profiles that are not already represented in the new tab dropdown menu. This is useful if you want to have a set of profiles that are always displayed at the top of the new tab dropdown menu, and then have the rest of the profiles displayed in a folder at the bottom of the new tab dropdown menu.

This will return a list of the remaining profiles, in the order they appear in theprofiles list.

{ "type": "remainingProfiles" }

Match Profiles

This entry type is similar to the remaining profiles entry. This entry will expand to a list of profiles that all match a given property. You can match based on the profiles byname,commandline, orsource.

For example:

{ "type": "matchProfiles", "source": "Microsoft.Terminal.Wsl" }

Will create a set of entries that are all profiles with thesource property set toMicrosoft.Terminal.Wsl. Note that thesource property is set from automatically generated profiles. If you are manually creating a profile and enter a custom source property, it will not be recognized by matchProfiles and the profile will not appear in the list.

A full string comparison is done on these properties - not a regex or partial string match.

Parameters

Action

This entry type represents a menu entry that should execute a specific action. The text for this menu entry will be the action's label (which is either provided as the "name" in the action's definition, or the generated name if no name was provided).

For more information, see thecustom actions and keybindings documentation.

{ "type": "action", "id": "User.MyCommand" }

Parameters