Startup settings in Windows Terminal

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.

Default profile

Set the default profile that opens by typing ctrl+shift+t , typing the key binding assigned to newTab , running wt new-tab without specifying a profile, or clicking the ‘+’ icon.

Property name: defaultProfile

Necessity: Required

Accepts: GUID or profile name as a string

Default value: PowerShell’s GUID

Launch on machine startup

When set to true , this enables the launch of Windows Terminal at startup. Setting this to false will disable the startup task entry.

Note: if the Windows Terminal startup task entry is disabled either by org policy or by user action this setting will have no effect.

Property name: startOnUserLogin

Necessity: Optional

Accepts: true , false

Default value: false

Launch mode

This defines whether the terminal will launch as maximized, full screen, or in a window. Setting this to focus is equivalent to launching the terminal in the default mode, but with focus mode enabled. Similarly, setting this to maximizedFocus will result in launching the terminal in a maximized window with focus mode enabled.

Property name: launchMode

Necessity: Optional

Accepts: «default» , «maximized» , «fullscreen» , «focus» , «maximizedFocus»

Default value: «default»

New instance behavior

This setting controls how new terminal instances attach to existing windows. This property is only used if the —window,-w window command line argument is not provided. This setting accepts the following possible values:

• useNew : Create a new window, always. This is how the terminal always behaved prior to version 1.7.
• useExisting : Create new tabs in the most recently used window on this desktop. If there’s not an existing window on this virtual desktop, then create a new terminal window.
• useAnyExisting : Create new tabs in the most recently used window, regardless of which virtual desktop the window is on.

Property name: windowingBehavior

Necessity: Optional

Accepts: «useNew» , «useExisting» , «useAnyExisting»

Default value: «useNew»

Launch size

Columns on first launch

This is the number of character columns displayed in the window upon first load. If launchMode is set to «maximized» or «maximizedFocus» , this property is ignored.

Property name: initialCols

Necessity: Optional

Accepts: Integer

Default value: 120

Rows on first launch

This is the number of rows displayed in the window upon first load. If launchMode is set to «maximized» or «maximizedFocus» , this property is ignored.

Property name: initialRows

Necessity: Optional

Accepts: Integer

Default value: 30

Launch position

This sets the pixel position of the top left corner of the window upon first load. On a system with multiple displays, these coordinates are relative to the top left of the primary display. If an X or Y coordinate is not provided, the terminal will use the system default for that value. If launchMode is set to «maximized» or «maximizedFocus» , the window will be maximized on the monitor specified by those coordinates.

Property name: initialPosition

Necessity: Optional

Accepts: Coordinates as a string in the following formats: «,» , «#,#» , «#,» , «,#»

Default value: «,»

Center on launch

When set to true , the terminal window will auto-center itself on the display it opens on. The terminal will use the «initialPosition» to determine which display to open on.

This interacts with the other launch settings in the following ways:

• «initialPos»: x,y , «centerOnLaunch»: true , «launchMode»: «default» : center on the monitor that x,y is on.
• «initialPos»: x,y , «centerOnLaunch»: true , «launchMode»: «maximized» : maximized on the monitor that x,y is on ( centerOnLaunch adds nothing).
• «initialPos»: , «centerOnLaunch»: true , «launchMode»: «default» : center on the default monitor.
• «initialPos»: , «centerOnLaunch»: true , «launchMode»: «focus» : center and enter focus mode on the default monitor.
• «initialPos»: , «centerOnLaunch»: true , «launchMode»: «maximized» : maximized on the default monitor ( centerOnLaunch adds nothing).

Property name: centerOnLaunch

Necessity: Optional

Accepts: true , false

Default value: false

Disable dynamic profiles

This sets which dynamic profile generators are disabled, preventing them from adding their profiles to the list of profiles on startup. For information on dynamic profiles, visit the Dynamic profiles page.

Property name: disabledProfileSources

Necessity: Optional

Accepts: «Windows.Terminal.Wsl» , «Windows.Terminal.Azure» , and/or «Windows.Terminal.PowershellCore» inside an array

Default value: []

Startup actions

This sets the list of actions to execute on startup, allowing the terminal to launch with a custom set of tabs and panes by default. These actions will be applied only if no command line arguments were supplied. The list of actions is represented by a string with the same format as commands in the command line arguments. For more information about the commands format, visit the Command line arguments page.

Property name: startupActions

Necessity: Optional

Accepts: String representing a list of commands to run

Install and set up Windows Terminal

Installation

You can install Windows Terminal from the Microsoft Store.

If you don’t have access to the Microsoft Store, the builds are published on the GitHub releases page. If you install from GitHub, the terminal will not automatically update with new versions.

First run

After installation, when you open the terminal, it will start with PowerShell as the default profile in the open tab.

Dynamic profiles

The terminal will automatically create profiles for you if you have WSL distros or multiple versions of PowerShell installed. Learn more about dynamic profiles on the Dynamic profiles page.

Open a new tab

You can open a new tab of the default profile by pressing Ctrl + Shift + T or by selecting the + (plus) button. To open a different profile, select the Л… (arrow) next to the + button to open the dropdown menu. From there, you can select which profile to open.

Invoke the command palette

You can invoke most features of Windows Terminal through the command palette. The default key combination to invoke it is Ctrl + Shift + P .

Open a new pane

You can run multiple shells side-by-side using panes. To open a pane, you can use Alt + Shift + + for a vertical pane or Alt + Shift + — for a horizontal one. You can also use Alt + Shift + D to open a duplicate pane of your focused profile. Learn more about panes on the Panes page.

Configuration

To customize the settings of your Windows Terminal, select Settings in the dropdown menu. This will open the settings.json file in your default text editor. (The default text editor is defined in your Windows settings.)

The terminal supports customization of global properties that affect the whole application, profile properties that affect the settings of each profile, and actions that allow you to interact with the terminal using your keyboard or the command palette.

You can also use the settings UI to configure your settings if you are using Windows Terminal Preview. You can learn how to open the settings UI on the Actions page.

Command line arguments

You can launch the terminal in a specific configuration using command line arguments. These arguments let you open the terminal with specific tabs and panes with custom profile settings. Learn more about command line arguments on the Command line arguments page.

Troubleshooting

If you encounter any difficulties using the terminal, reference the Troubleshooting page. If you find any bugs or have a feature request, you can select the feedback link in the About menu of the terminal to go to the GitHub page where you can file a new issue.

Установка и настройка Терминала Windows Install and set up Windows Terminal

Установка Installation

Терминал Windows можно установить из Microsoft Store. You can install Windows Terminal from the Microsoft Store.

Если у вас нет доступа к Microsoft Store, можно скачать сборки, опубликованные на странице выпусков GitHub. If you don’t have access to the Microsoft Store, the builds are published on the GitHub releases page. При установке из GitHub терминал не будет автоматически обновляться с установкой новых версий. If you install from GitHub, the terminal will not automatically update with new versions.

Первый запуск First run

После установки при открытии терминала он запустится с помощью PowerShell в качестве профиля по умолчанию в открытой вкладке. After installation, when you open the terminal, it will start with PowerShell as the default profile in the open tab.

Динамические профили Dynamic profiles

Если у вас установлены дистрибутивы WSL или несколько версий PowerShell, терминал автоматически создаст профили. The terminal will automatically create profiles for you if you have WSL distros or multiple versions of PowerShell installed. Дополнительные сведения о динамических профилях см. на этой странице. Learn more about dynamic profiles on the Dynamic profiles page.

Открытие новой вкладки Open a new tab

Новую вкладку профиля по умолчанию можно открыть, нажав сочетание клавиш Ctrl+Shift+T или кнопку «+» (плюс). You can open a new tab of the default profile by pressing ctrl+shift+t or by selecting the + (plus) button. Открыть другой профиль можно с помощью раскрывающегося меню. Для этого щелкните «˅» (стрелка) рядом с кнопкой «+». To open a different profile, select the ˅ (arrow) next to the + button to open the dropdown menu. Из этого меню можно выбрать, какой профиль следует открыть. From there, you can select which profile to open.

Открытие новой панели Open a new pane

Вы можете параллельно запустить несколько оболочек с помощью панелей. You can run multiple shells side-by-side using panes. Чтобы открыть панель, нажмите сочетание клавиш ALT+SHIFT+D . To open a pane, you can use alt+shift+d . С помощью этого настраиваемого сочетания клавиш можно открыть еще одну панель выделенного профиля. This key binding will open a duplicate pane of your focused profile. Дополнительные сведения о панелях см. на этой странице. Learn more about panes on the Panes page.

Конфигурация Configuration

Чтобы выполнить настройку параметров Терминала Windows, в раскрывающемся меню выберите Параметры. To customize the settings of your Windows Terminal, select Settings in the dropdown menu. В текстовом редакторе по умолчанию откроется файл settings.json . This will open the settings.json file in your default text editor. (Текстовый редактор по умолчанию определяется в параметрах Windows.) (The default text editor is defined in your Windows settings.)

Терминал поддерживает настройку глобальных свойств, влияющих на все приложение, свойств профиля, влияющих на параметры каждого профиля, а также сочетания клавиш, позволяющих взаимодействовать с терминалом с помощью клавиатуры. The terminal supports customization of global properties that affect the whole application, profile properties that affect the settings of each profile, and key bindings that allow you to interact with the terminal using your keyboard.

Аргументы командной строки Command line arguments

Вы можете запустить терминал в определенной конфигурации с помощью аргументов командной строки. You can launch the terminal in a specific configuration using command-line arguments. С помощью этих аргументов можно открыть терминал с конкретными вкладками и панелями, применяя параметры настраиваемого профиля. These arguments let you open the terminal with specific tabs and panes with custom profile settings. Дополнительные сведения об аргументах командной строки см. на этой странице. Learn more about command-line arguments on the Command line arguments page.

Диагностика Troubleshooting

В случае возникновения каких-либо проблем при использовании терминала посетите страницу устранения неполадок. If you encounter any difficulties using the terminal, reference the Troubleshooting page. Если вы заметите какие-либо ошибки или захотите отправить запрос функции, щелкните в меню терминала О программе ссылку «Отзыв», чтобы перейти на страницу GitHub и сообщить об ошибке. If you find any bugs or have a feature request, you can select the feedback link in the About menu of the terminal to go to the GitHub page where you can file a new issue.

What is Windows Terminal?

Windows Terminal is a modern terminal application for users of command-line tools and shells like Command Prompt, PowerShell, and Windows Subsystem for Linux (WSL). Its main features include multiple tabs, panes, Unicode and UTF-8 character support, a GPU accelerated text rendering engine, and the ability to create your own themes and customize text, colors, backgrounds, and shortcuts.

Multiple profiles supporting a variety of command line applications

Any application that has a command line interface can be run inside Windows Terminal. This includes everything from PowerShell and Command Prompt to Azure Cloud Shell and any WSL distribution such as Ubuntu or Oh-My-Zsh.

Customized schemes and configurations

You can configure your Windows Terminal to have a variety of color schemes and settings. To learn how to make your own color scheme, visit the Color schemes page. You can also find custom Terminal configurations in the Custom terminal gallery.

Custom actions

There are a variety of custom commands you can use in Windows Terminal to have it feel more natural to you. If you don’t like a particular keyboard shortcut, you can change it to whatever you prefer.

For example, the default shortcut to copy text from the command line is ctrl+shift+c . You can change this to ctrl+1 or whatever you prefer. To open a new tab, the default shortcut is ctrl+shift+t , but maybe you want to change this to ctrl+2 . The default shortcut to flip between the tabs you have open is ctrl+tab , this could be changed to ctrl+- and used to create a new tab instead.

You can learn about customizing shortcuts on the Actions page.

Unicode and UTF-8 character support

Windows Terminal can display Unicode and UTF-8 characters such as emoji and characters from a variety of languages.

GPU accelerated text rendering

Windows Terminal uses the GPU to render its text, thus providing improved performance over the default Windows command line experience.

Background image support

You can have background images and gifs inside your Windows Terminal window. Information on how to add background images to your profile can be found on the Profile — Appearance page.

Command line arguments

You can set Windows Terminal to launch in a specific configuration using command line arguments. You can specify which profile to open in a new tab, which folder directory should be selected, open the terminal with split window panes, and choose which tab should be in focus.

For example, to open Windows Terminal from PowerShell with three panes, with the left pane running a Command Prompt profile and the right pane split between your PowerShell and your default profile running WSL, enter:

Learn how to set up command-line arguments on the Command line arguments page.