Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Customize Windows Terminal from Settings for the graphical controls or from settings.json for direct editing. Application-wide options—such as the app theme—belong at the top level of the file; shell-specific options belong in a profile, or in profiles.defaults if you want them shared. This distinction lets you personalize the Terminal window without accidentally applying a setting to the wrong shell.

Microsoft describes Windows Terminal as “a modern host application for the command-line shells you already love, like Command Prompt, PowerShell, and bash (via Windows Subsystem for Linux (WSL)).” Its settings customize that host and its profiles. Prompt appearance and aliases inside PowerShell or WSL are configured separately. Microsoft Learn: An overview on Windows Terminal.

Open Settings and find the right configuration file

Open Windows Terminal, select the dropdown arrow beside the tab bar, then choose Settings. You can make many changes in the graphical interface, or choose Open JSON file in Settings to edit the configuration directly. Using that command is the safest way to locate the active file: its location depends on whether Terminal is installed as a packaged or unpackaged application. Microsoft documents the installation-dependent locations and settings workflow in its installation documentation.

The file settings.json contains your editable configuration. defaults.json is useful for inspecting available defaults, but Microsoft says edits to it are ignored. For setting names and accepted values, consult the relevant settings documentation.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
#1 Best Overall
Sale
Logitech K120 Full Size Wired Keyboard USB Plug-and-Play Windows - Black
  • All-day Comfort: The design of this standard keyboard creates a comfortable typing experience thanks to the deep-profile keys and full-size standard layout with F-keys and number pad
  • Easy to Set-up and Use: Set-up couldn't be easier, you simply plug in this corded keyboard via USB on your desktop or laptop and start using right away without any software installation
  • Compatibility: This full-size keyboard is compatible with Windows 7, 8, 10 or later, plus it's a reliable and durable partner for your desk at home, or at work
  • Spill-proof: This durable keyboard features a spill-resistant design (1), anti-fade keys and sturdy tilt legs with adjustable height, meaning this keyboard is built to last
  • Plastic parts in K120 include 51% certified post-consumer recycled plastic*

Know which settings apply where

  • Root of settings.json: app-wide behavior and appearance, such as the Terminal theme.
  • profiles.defaults: shared settings for profiles, such as a background or color preference.
  • profiles.list: individual profile objects, where a shell can override the shared defaults.
  • Command-line options: one-time launch choices that do not have to change a saved profile.

A profile represents a command-line application or shell configuration. This scope model is the key to making a change once, in the right place, rather than repeating it across profiles.

Change the Terminal app’s overall appearance

To change the window’s theme, set the root-level theme property to system, dark, light, or the name of a custom theme. The documented default is system. This theme changes the Terminal application’s interface; it is distinct from a profile’s terminal color scheme, which controls the colors used in that shell.

Window-level appearance options also cover tab visibility, title-bar behavior, and tab placement. For example, the alwaysShowTabs setting may require a new Terminal instance before its change takes effect, as noted in Microsoft’s appearance settings reference. Check the individual property’s documentation for whether reopening is needed.

Set shared preferences, then customize individual profiles

In Settings, select a profile from the sidebar to edit its name, command line, starting directory, icon, tab title, and appearance. In JSON, profile-specific properties go in that profile’s object under profiles.list. Put a preference in profiles.defaults when it should apply to profiles generally, then override it in an individual profile if one shell needs different behavior.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Profile order matters for index-based shortcuts such as Ctrl+Shift+1: the index follows the order of profiles in the list. If you reorder profiles, check any shortcuts or workflows that rely on those indexes. Microsoft’s profile general settings reference describes the available profile properties.

Choose or create a profile color scheme

Start with a named built-in scheme or add a custom scheme object in the schemes section of settings.json, then assign its name to the profile’s colorScheme property. Microsoft provides examples and instructions in its custom color schemes guide.

Rank #3
I Focus Mini 78 Keys Wired Keyboard - with Cover Computer keypad for Laptop MAC Windows 10/8 / 7 / Vista/XP(Black+Keyboard Film)
  • Portable 78-Key Computer Wired Keyboard, signal transmission is stable, and the line length is 1.3 meters (equal to 51 inches). Size:28x12x1.8cm
  • Comfortable switch - Provides you with improved typing speed and accuracy. Over 15 million keystroke tests, keyboard is durability.
  • High Quality ABS Production - Use strong grade and strong, environmental protection materials, the keyboard bottom has anti-slip mat, will not move, convenient your work.
  • FN Shortcuts - Easy access to media controls such as playback, pause, next and previous tracking, increase volume, etc. The Number Function keys Hide under the letter, saving your space, and more convenient and fast.
  • Simple Plug and PLay for Windows - Compatible with desktops and laptops with Windows 10, Windows 8, 7, Vista, XP, Chrome OS and Mac.

A profile can also use separate light and dark schemes by setting colorScheme to an object with light and dark entries. The active scheme follows the app theme; when the app theme is set to system, the operating system’s theme determines which is used.

For a small exception to a scheme, set profile-level foreground, background, selectionBackground, or cursorColor overrides. Prefer changing the scheme first, then use overrides only where necessary, so a later palette adjustment remains manageable. Microsoft lists profile appearance properties in its profile appearance reference.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Add a background image or profile icon

Background image properties belong to a profile (or to shared defaults if you want the same image across profiles). The settings include an image path, alignment, stretch mode, and opacity; opacity is a floating-point value from 0 to 1. The documented supported formats include JPG, PNG, and GIF. Alignment determines placement, while stretch mode controls how the image fits the terminal area.

Rank #4
Bloomberg Terminal Reference Keyboard Hotkeys Decals for Windows Black, White Background
  • Features essential hotkey shortcuts to increase productivity. Conveniently organized sections. Simple formatting.
  • Includes basic commands as well as other useful tools.
  • Decals available for most common Operation Systems. Legend for commonly-used symbols.
  • Appropriately sized to accommodate most surfaces.

You can set a profile icon with an image file path. Microsoft recommends a 32 × 32 pixel icon to avoid runtime scaling and loss of quality. Its current appearance reference also documents path options, including Local and Roaming app-data locations and URI schemes for stored files. Avoid relying on ms-appx references: Microsoft warns these point to internal implementation details that may change or disappear. The documented image and icon settings may refer to content adjacent to settings.json as of Windows Terminal 1.24; check the current reference if you use a later release.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Customize keyboard shortcuts and actions

Terminal actions control host behavior, such as opening a tab or copying text. Open the Actions page in Settings to review the action names and keybindings available in your installed version. You can edit shortcuts there or configure custom actions in settings.json. Microsoft’s actions and key bindings guide explains the syntax and includes examples for changing copy and new-tab shortcuts.

These shortcuts affect Windows Terminal itself. A shell alias, PowerShell prompt, or WSL prompt is configured in that shell’s own settings rather than through Terminal’s Actions page.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Best Value
Cherry KC 1000, Smartcard Keyboard (JK-A0100EU-2)
  • Wired security keyboard with integrated chip card terminal
  • Secure PIN entry
  • PC/SC smartcard reader
  • Protocols: T=0, T=1, S=8, S=9, S=10
  • FIPS 201 Approved

Launch a profile or layout with the wt command

Use wt when you want a repeatable launch choice—such as a particular profile, starting directory, tab, or split pane—without changing the profile’s saved appearance. The options -p and -d select a profile and starting directory, while commands such as new-tab and split-pane build a multi-pane layout. Microsoft’s command-line arguments reference documents the syntax and examples.

For example, this opens a PowerShell profile in a specified directory:

wt -p "PowerShell" -d C:work

To open a tab and then split it, use the documented command syntax, substituting the profile and directory you need:

wt new-tab -p "PowerShell" -d C:work ; split-pane -p "Command Prompt" -d C:work

In PowerShell, semicolons are special characters, so escape the delimiter with a backtick when entering a command like this directly:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
wt new-tab -p "PowerShell" -d C:work `; split-pane -p "Command Prompt" -d C:work

Execution aliases do not work from inside WSL. Microsoft documents invoking wt.exe through cmd.exe from WSL as the alternative; see the command-line arguments reference.

Quick Recap

SaleBestseller No. 1
Logitech K120 Full Size Wired Keyboard USB Plug-and-Play Windows - Black
Logitech K120 Full Size Wired Keyboard USB Plug-and-Play Windows - Black
Plastic parts in K120 include 51% certified post-consumer recycled plastic*; Product carbon footprint: 4.02 kg CO2e
$12.34
Bestseller No. 4
Bloomberg Terminal Reference Keyboard Hotkeys Decals for Windows Black, White Background
Bloomberg Terminal Reference Keyboard Hotkeys Decals for Windows Black, White Background
Includes basic commands as well as other useful tools.; Decals available for most common Operation Systems. Legend for commonly-used symbols.
$5.60
Bestseller No. 5
Cherry KC 1000, Smartcard Keyboard (JK-A0100EU-2)
Cherry KC 1000, Smartcard Keyboard (JK-A0100EU-2)
Wired security keyboard with integrated chip card terminal; Secure PIN entry; PC/SC smartcard reader
$34.99

Apply changes and troubleshoot scope

  • If a change affects every shell, check whether it belongs at the root or in profiles.defaults.
  • If only one shell should change, put the property in that profile rather than at the root.
  • If an image or icon does not appear, verify its path, supported format, and file availability.
  • If a setting appears unchanged, check whether its documentation requires a new Terminal instance.
  • If a command works in Command Prompt but not PowerShell, check whether a semicolon needs escaping.
  • If an index-based shortcut opens the wrong profile, review the profile order in profiles.list.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.