title | description | author | ms.author | ms.date | ms.topic |
---|---|---|---|---|---|
Windows Terminal Advanced Profile Settings |
Learn how to customize the advanced profile settings within Windows Terminal. |
nguyen-dows |
chrnguyen |
04/13/2022 |
how-to |
The settings listed below are specific to each unique profile. If you'd like a setting to apply to all of your profiles, you can add it to the defaults
section above the list of profiles in your settings.json file.
"defaults":
{
// SETTINGS TO APPLY TO ALL PROFILES
},
"list":
[
// PROFILE OBJECTS
]
When this is set to true
, tabTitle
overrides the default title of the tab and any title change messages from the application will be suppressed. If tabTitle
isn't set, name
will be used instead. When this is set to false
, tabTitle
behaves as normal.
Property name: suppressApplicationTitle
Necessity: Optional
Accepts: true
, false
This controls how text is antialiased in the renderer. Note that changing this setting will require starting a new terminal instance.
Property name: antialiasingMode
Necessity: Optional
Accepts: "grayscale"
, "cleartype"
, "aliased"
Default value: "grayscale"
This allows you to control if Windows Terminal will treat ctrl+alt as an alias for AltGr.
Property name: altGrAliasing
Necessity: Optional
Accepts: true
, false
Default value: true
When this is set to true
, the window will scroll to the command input line when typing. When it's set to false
, the window will not scroll when you start typing.
Property name: snapOnInput
Necessity: Optional
Accepts: true
, false
Default value: true
This sets the number of lines above the ones displayed in the window you can scroll back to. The maximum history size is 32767
.
Property name: historySize
Necessity: Optional
Accepts: Integer
Default value: 9001
This sets how the profile reacts to termination or failure to launch. "graceful"
will close the profile when exit
is typed or when the process exits normally. "always"
will always close the profile and "never"
will never close the profile. true
and false
are accepted as synonyms for "graceful"
and "never"
, respectively.
Property name: closeOnExit
Necessity: Optional
Accepts: "graceful"
, "always"
, "never"
, true
, false
Default value: "graceful"
Note
In Windows Command Prompt (cmd.exe), exit
will return the return code of the previous command. If the command you typed before exit
resulted in an error, then "closeOnExit": "graceful"
will still show that error code, instead of closing the tab.
Controls what happens when the application emits a BEL character. When set to "all"
, the terminal will play a sound and flash the taskbar icon. When the terminal is not in focus, only the taskbar icon will flash.
Property name: bellStyle
Necessity: Optional
Accepts: "all"
, "audible"
, "window"
, "taskbar"
, "none"
Default value: "audible"
When bellStyle
is set to "all"
or "audible"
, this allows you to choose the audio file for the bell. If you have an array of sounds set, the terminal will pick one at random.
Property name: bellSound
Necessity: Optional
Accepts: File location as a string or an array of file locations as strings
Scroll marks (Preview)
The following settings modify how scroll marks behave in Windows Terminal.
Experimental automatically add scroll marks (Preview)
Automatically marks prompts when set to true
. This is an experimental feature, and its continued existence is not guaranteed.
Property name: experimental.autoMarkPrompts
Necessity: Optional
Accepts: true
, false
Important
This feature is only available in Windows Terminal Preview.
Experimental show marks on scrollbar (Preview)
Displays marks on the scrollbar when set to true
. This is an experimental feature, and its continued existence is not guaranteed.
Property name: experimental.showMarksOnScrollbar
Necessity: Optional
Accepts: true
, false
Important
This feature is only available in Windows Terminal Preview.
Enables use of the experimental text rendering engine for the profile. This is an experimental feature and its continued existence is not guaranteed. A new instance of the profile needs to be opened in order for this setting to take effect.
Property name: experimental.useAtlasEngine
Necessity: Optional
Accepts: true
, false
Default value: false
Right click context menu (Preview)
When enabled, right-click will open a context menu with options to copy, paste, and more. When disabled, right-click will paste the contents of the clipboard into the terminal. With shell integration enabled, right-click will also allow you to select the current command or output. This is an experimental feature, and its continued existence is not guaranteed.
Property name: experimental.rightClickContextMenu
Necessity: Optional
Accepts: true
, false
Default value: false
Important
This feature is only available in Windows Terminal Preview.
When set to true, directs the PTY for this connection to use pass-through mode instead of the original Conhost PTY simulation engine. This is an experimental feature, and its continued existence is not guaranteed.
Property name: experimental.connection.passthroughMode
Necessity: Optional
Accepts: true
, false
Default value: false
Profiles can use a GUID as a unique identifier. To make a profile your default profile, it needs a GUID for the defaultProfile
global setting.
Property name: guid
Necessity: Required
Accepts: GUID as a string in registry format: "{00000000-0000-0000-0000-000000000000}"
Tip
You can run [guid]::NewGuid()
in PowerShell to generate a GUID for your custom profile. You can also use the online GUID generator or for other command lines, use the UUID generator.
This stores the name of the profile generator that originated the profile. There are no discoverable values for this field. For additional information on dynamic profiles, visit the Dynamic profiles page.
Property name: source
Necessity: Optional
Accepts: String
Note
This field should be omitted when declaring a custom profile. It is used by Terminal to connect automatically generated profiles to your settings file.