Terminal Appearance
AI agents: See llms.txt for documentation discovery and navigation. Documentation articles are also available as Markdown by appending .md to the article URL. Join VS Code at Microsoft Ignite or catch the sessions online. A year of VS Code, wrapped. Explore the highlights. Terminal Appearance View as Markdown Ask in VS Code Ask in VS Code Insiders The look of Visual Studio Code's terminal can be customized extensively.
Sapphire theme with custom Starship prompt using the font Hack with Nerd Font symbols Text style Text in the terminal can be customized with the following settings: terminal.integrated.fontFamily Open in VS Code Open in VS Code Insiders : The font family to use, this takes a string in the format that fontFamily in CSS takes. For example, "'Fira Code', monospace" will configure Fira Code as the primary font and monospace as the fallback when it lacks glyphs. terminal.integrated.fontSize Open in VS Code Open in VS Code Insiders : Changes the font size of text in the terminal. terminal.integrated.letterSpacing Open in VS Code Open in VS Code Insiders : Configures additional horizontal spacing between characters in pixels. terminal.integrated.lineHeight Open in VS Code Open in VS Code Insiders : Configures additional vertical spacing between characters as a multiplier of the regular line height.
For example, 1.1 will add 10% additional vertical space. terminal.integrated.fontWeight Open in VS Code Open in VS Code Insiders : Configures the font weight of "normal" text. terminal.integrated.fontWeightBold Open in VS Code Open in VS Code Insiders : Configures the font weight of "bold" text. terminal.integrated.fontRendering Open in VS Code Open in VS Code Insiders (Experimental) : On macOS high-DPI displays, set this to grayscale to make terminal text appear sharper.
Use inherit to keep the system font-rendering behavior. terminal.integrated.fontLigatures.* : Configure ligatures . Powerline symbols and Nerd Fonts Powerline fonts are special patched fonts that contain additional characters that can be used in the terminal. VS Code's terminal renders some of the Powerline symbols without needing to configure a font , but if more glyphs are desired, configure a Powerline font with the font family setting.
Powerline fonts typically end in " for Powerline" , the following setting is an example of how to configure a DejaVu Sans Mono that has been patched: "editor.fontFamily" : "'DejaVu Sans Mono for Powerline'" Nerd Fonts work the same and typically have a " NF" suffix, the following is an example of how to configure Hack's nerd fonts variant: "terminal.integrated.fontFamily" : "'Hack NF'" Terminal cursor The terminal cursor style and whether it blinks can be customized with the following settings: terminal.integrated.cursorStyle Open in VS Code Open in VS Code Insiders : Defines the shape of the cursor, can be block, line or underline. terminal.integrated.cursorWidth Open in VS Code Open in VS Code Insiders : How wide in pixels the cursor should be when the cursor style is set to line . terminal.integrated.cursorBlinking Open in VS Code Open in VS Code Insiders : Whether the cursor should blink when the terminal is focused. terminal.integrated.cursorStyleInactive Open in VS Code Open in VS Code Insiders : Defines the shape of the cursor, can be outline, block, line, underline or none.
Customizing tabs Terminal tabs appear on the right of the terminal view when there are two or more terminals by default, showing the active terminal in the view header when there is only one. Visibility The default visibility is designed to save horizontal space, but may not be desirable. How tabs are presented can be configured with the following settings: terminal.integrated.tabs.hideCondition Open in VS Code Open in VS Code Insiders : When to hide the tabs to the right, set to never to always show them. terminal.integrated.tabs.showActiveTerminal Open in VS Code Open in VS Code Insiders : When to show the active terminal in the terminal view header. terminal.integrated.tabs.showActions Open in VS Code Open in VS Code Insiders : When to show the active terminal's actions in the view header. terminal.integrated.tabs.location Open in VS Code Open in VS Code Insiders : Whether the tabs should be shown on the left or right of the terminal. terminal.integrated.tabs.enabled Open in VS Code Open in VS Code Insiders : Whether to use tabs, disabling will show the original dropdown view.
Tab text The text on each tab is determined by the following settings: terminal.integrated.tabs.title Open in VS Code Open in VS Code Insiders : Tab title. terminal.integrated.tabs.description Open in VS Code Open in VS Code Insiders : Text that appears to the right of the title. terminal.integrated.tabs.separator Open in VS Code Open in VS Code Insiders : Separator character between the title and description. By default, the title displays what the shell's detected process name.
Other terminals often display the escape sequence sent by the shell as the title, which can be configured with: "terminal.integrated.tabs.title" : "${sequence}" Here are all variables available for use: ${cwd} : the terminal's current working directory. ${cwdFolder} : the terminal's current working directory, displayed for multi-root workspaces or in a single root workspace when the value differs from the initial working directory.
On Windows, this will only be displayed when shell integration is enabled. ${workspaceFolder} : the workspace in which the terminal was launched. ${workspaceFolderName} : the name of the workspace in which the terminal was launched. ${local} : indicates a local terminal in a remote workspace. ${process} : the name of the terminal process. ${progress} : the progress state as reported by the OSC 9;4 sequence. ${separator} : a conditional separator (-) that only shows when it's surrounded by variables with values or static text. ${sequence} : the name provided to the terminal by the process. ${task} : indicates this terminal is associated with a task. ${shellType} : the detected shell type. ${shellCommand} : the command being executed according to shell integration.
This also requires high confidence in the detected command line, which may not work in some prompt frameworks. ${shellPromptInput} : the shell's full prompt input according to shell integration. Icons Each terminal has an associated icon that is determined by its terminal profile . The default icon and its color, which will be used if not defined in a profile, can be configured with the terminal.integrated.tabs.defaultIcon Open in VS Code Open in VS Code Insiders and terminal.integrated.tabs.defaultColor Open in VS Code Open in VS Code Insiders settings.
Status A terminal's "status", if any, is signified by an icon that appears on the right of the tab. Some statuses involve animation. If this is distracting the animation can be disabled with: "terminal.integrated.tabs.enableAnimation" : false Visual bell When the terminal's bell is triggered, a yellow bell icon is briefly shown. This can be disabled with terminal.integrated.enableBell Open in VS Code Open in VS Code Insiders and the duration can be configured with terminal.integrated.bellDuration Open in VS Code Open in VS Code Insiders .
Terminal colors While the terminal is capable of displaying true color, programs commonly use 8 ANSI colors (black, red, green, yellow, blue, magenta, cyan and white) and bright variants of each. These ANSI colors are determined by the active color theme , but they can also be configured independently from the theme with the workbench.colorCustomizations setting. Whether bold text uses the normal ANSI colors or the bright variant can be configured with the terminal.integrated.drawBoldTextInBrightColors Open in VS Code Open in VS Code Insiders setting.
Minimum contrast ratio Terminals often have contrast issues due to some conflict with dark/light themes, ANSI colors or shells/programs running, and more. The minimum contrast ratio feature solves
The rest of this page is on the live site.