Windows Terminal customization can be mastered through a three-level setup: basic appearance changes, profile and keybinding tweaks, and advanced settings like color schemes and custom actions. This guide walks you through each level, from changing the font to creating custom keybindings, so you can make Windows Terminal truly yours.
Background: What Is Windows Terminal?
Windows Terminal is a modern, tabbed host for command-line tools like PowerShell, Command Prompt, and Windows Subsystem for Linux (WSL). It was introduced by Microsoft in 2019 and has become the default terminal for many Windows users because of its speed, GPU-accelerated rendering, and deep customization options. Unlike the legacy console host, Windows Terminal supports tabs, panes, and a JSON-based settings file that lets you control nearly every aspect of its behavior and appearance.
The settings file is stored at %LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json (or via the Settings UI, which is easier for beginners). You can open it by pressing Ctrl+, or by clicking the dropdown arrow next to the new tab button and selecting Settings. The JSON structure is the backbone of all three customization levels.
Level 1: Basic Appearance – Fonts, Colors, and Background
Level 1 is about making the terminal look good without touching any code. The Settings UI (available in Windows Terminal 1.12 and later) lets you change:
- Font face and size – Choose from installed monospace fonts like Cascadia Code (the default), Consolas, or JetBrains Mono. You can also enable font features like ligatures.
- Color scheme – Pick from built-in schemes like Campbell, One Half Dark, or Solarized. You can also create a custom scheme by editing the JSON.
- Background image – Set a custom image, adjust its opacity, and choose a background alignment mode (stretch, fill, etc.).
- Opacity and blur – Use the
opacityanduseAcrylicsettings to make the background translucent (Acrylic blur) or fully transparent.
For example, to set a background image, go to Settings > Profile > Appearance and browse for an image. The JSON equivalent is:
"backgroundImage": "C:\\path\\to\\image.jpg",
"backgroundImageOpacity": 0.5,
"backgroundImageStretchMode": "fill"
This level is about visual comfort and identity. Many users start here because it immediately changes the feel of the terminal.
Level 2: Profiles and Keybindings – Making It Yours
Level 2 involves configuring multiple profiles and customizing keyboard shortcuts to speed up your workflow. Windows Terminal supports multiple profiles, each with its own settings for command line, starting directory, icon, and appearance.
To add a new profile, you can either use the Settings UI (click Add new profile) or edit the JSON directly. A typical profile entry looks like:
{
"name": "PowerShell",
"commandline": "powershell.exe",
"icon": "ms-appx:///ProfileIcons/powershell.png",
"startingDirectory": "C:\\Users\\yourname",
"colorScheme": "One Half Dark"
}
Keybindings are defined in the actions array in the JSON. For example, to split the terminal horizontally with a new profile, you can add:
{"command": {"action": "splitPane", "split": "right", "profile": "PowerShell"}, "keys": "ctrl+shift+1"}
You can also bind actions like newTab, closePane, nextTab, and even custom commands that run a specific command line. The Settings UI has a Keyboard shortcuts page where you can see and edit all existing bindings without touching JSON.
This level also includes setting default profiles, defining custom color schemes (with up to 16 colors plus foreground and background), and configuring the tab title behavior.
Level 3: Advanced Customization – Color Schemes, Actions, and Startup
Level 3 is where you dive into the full power of the JSON settings. This includes creating your own color schemes, defining complex actions, and controlling startup behavior.
Custom color schemes are defined in the schemes array. Each scheme has 16 color slots (for ANSI colors) plus foreground, background, and cursor colors. For example:
{
"name": "MyScheme",
"foreground": "#FFFFFF",
"background": "#0C0C0C",
"cursorColor": "#FFFFFF",
"black": "#0C0C0C",
"red": "#C50F1F",
...
}
You can also use the colorTable array instead of named keys. To apply a scheme to a profile, set "colorScheme": "MyScheme".
Actions are not just keybindings; they can also be added to the tab context menu or the new tab dropdown. For example, you can create a command that runs a specific script and assign it to a key or a menu entry. The command can be a string (like "newTab") or an object with parameters.
Startup settings control what happens when Windows Terminal launches. You can set the default profile, the starting directory, the window size, and whether to launch maximized or fullscreen. For instance:
"startOnUserLogin": true,
"launchMode": "maximized",
"initialCols": 120,
"initialRows": 30
You can also configure actions to open multiple panes automatically at startup by using the startupActions setting, like "startupActions": "newTab; splitPane -H".
Level 3 also includes using profiles with backgroundImage per profile, setting padding and scrollbarState, and using experimental.retroTerminalEffect for a CRT look (though that is experimental and may change).
How to Choose Your Customization Path
Start with Level 1 if you only want a nicer look. Use Level 2 if you work with multiple shells or want to speed up common tasks. Go to Level 3 when you have specific needs like a unique color palette, automated startup layouts, or custom menu items.
Consider your workflow: if you use only PowerShell, a single profile with a good color scheme may be enough. If you frequently switch between PowerShell, CMD, and WSL, you’ll benefit from distinct profiles and keybindings to open them quickly. If you like to have a specific layout every time you start the terminal, Level 3’s startup actions are invaluable.
Common Problems and How to Fix Them
- Settings file errors – If you edit JSON manually and make a syntax error, Windows Terminal will show a warning and revert to the last working settings. Use the Settings UI for changes to avoid this, or validate your JSON with a tool like VS Code.
- Font not applying – Ensure the font is installed and is a monospace font. Some fonts like Cascadia Code come with Windows Terminal but others need to be installed system-wide.
- Background image not showing – Check the file path is correct and the image is accessible. Use forward slashes or double backslashes in JSON.
- Keybinding not working – Make sure the command is valid and the keys are not already bound. Check the Keyboard shortcuts page in Settings to see conflicts.
- Color scheme not appearing – If you add a scheme manually, ensure it is in the
schemesarray and that the profile references it by exact name.
Comparison: Windows Terminal vs. Other Terminals
Windows Terminal is often compared to third-party terminals like ConEmu, Cmder, or Hyper. Windows Terminal is built by Microsoft, deeply integrated with Windows, and supports GPU acceleration, which makes it very fast. ConEmu and Cmder are mature and have many features, but they are not as actively developed as Windows Terminal. Hyper is Electron-based, so it can be slower and uses more memory. Windows Terminal’s main advantage is its native support for WSL and its modern JSON-based configuration, which is more flexible than the GUI-only settings of some alternatives.
Safety and Backup
Editing settings.json is safe as long as you make a backup first. Windows Terminal automatically creates a backup of your settings when you open the Settings UI, but if you edit the file manually, it’s a good practice to copy it to a safe location. Also, avoid using experimental features in production environments, as they may change or break in future updates. If you ever mess up, you can reset to defaults by deleting the settings.json file (Windows Terminal will recreate it with default settings).
One common misconception is that you need to know programming to customize Windows Terminal. In reality, the Settings UI covers most Level 1 and Level 2 options, and even Level 3 can be done by copying examples from the official documentation. The JSON is straightforward, and the community has many examples.
Frequently Asked Questions
How do I change the font in Windows Terminal?
Go to Settings > Profile (the one you use) > Appearance > Font face. Choose from the dropdown or type the name of an installed monospace font. You can also set the font size in the same section.
Can I have different color schemes for different profiles?
Yes. Each profile has its own colorScheme setting. You can create multiple schemes in the schemes array and assign them to different profiles. For example, use a light scheme for PowerShell and a dark one for WSL.
How do I add a custom keybinding to open a specific profile?
In the Settings UI, go to Keyboard shortcuts and click Add new. Select the command (e.g., New tab) and then choose the profile you want. Alternatively, edit the JSON and add an action like {"command": {"action": "newTab", "profile": "Ubuntu"}, "keys": "ctrl+shift+u"}.
Why is my background image not showing?
Check that the path is correct and that the image file is not corrupted. In JSON, use forward slashes (e.g., C:/Users/name/image.jpg) or double backslashes (C:\\Users\\name\\image.jpg). Also, ensure that backgroundImageOpacity is not set to 0.
Can I make Windows Terminal start with a specific layout?
Yes. Use the startupActions setting in the global settings. For example, "startupActions": "newTab; splitPane -H" will open a new tab and then split it horizontally. You can also set launchMode to maximized or fullscreen.
Is it possible to reset Windows Terminal to default settings?
Yes. Delete the settings.json file from the LocalState folder (or use the Settings UI and click Reset at the bottom of the page). Windows Terminal will recreate the file with default settings on the next launch.
Related
General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.
More in this bed
- How to Move Data to a New Samsung Galaxy Phone
- Pixel C vs Surface Pro: Key Differences
- iPhone X vs iPhone: Key Differences Explained
- Chromebook Won’t Charge: How to Fix
- How to Delete Photos on Google Drive
- Firefox Bookmark Management Tips & Tricks