◆Error Codes Wiki

Windows Terminal Errors — Profile Launch Failures and Rendering Issues

Informationalapplication

Overview

Fix Windows Terminal errors including profile launch failures, GPU rendering errors, font issues, and configuration (settings.json) parsing errors.

Key Details

  • Windows Terminal is the modern terminal app supporting PowerShell, CMD, WSL, and custom shells
  • Configuration stored in settings.json — syntax errors here prevent Terminal from loading profiles
  • GPU-accelerated rendering can cause blank screens on systems with incompatible drivers
  • Custom font issues (Nerd Fonts, Cascadia Code) can cause rendering glitches or crashes
  • Windows Terminal requires Windows 10 1903+ and is pre-installed on Windows 11

Common Causes

  • Syntax error in settings.json (missing comma, unmatched bracket, invalid JSON)
  • Custom shell path in profile pointing to a non-existent executable
  • GPU rendering driver incompatibility causing blank or flickering terminal window
  • Missing font specified in the profile's font face setting

Steps

  1. 1Reset settings: delete or rename %LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json
  2. 2Fix JSON syntax errors: open settings.json in VS Code which highlights JSON errors
  3. 3Disable GPU rendering: add '"disablePartialInvalidation": true, "softwareRendering": true' to settings.json globals
  4. 4Fix profile path: ensure the commandline in each profile points to an existing executable
  5. 5Install missing fonts: download Cascadia Code from GitHub and install via right-click > Install

Tags

windows-terminalsettings-jsonterminalpowershellprofile

Related Items

windows-powershell-execution-policy-error

More in Application

windows-C0000005-access-violationWindows Error 0xC0000005 — Access Violation
Error
windows-C000007B-bad-image-formatWindows Error 0xC000007B — Bad Image Format
Error
windows-C0000142-application-init-failedWindows Error 0xC0000142 — Application Init Failed
Error
windows-SxS-Error-side-by-side-configuration-errorWindows Error SxS-Error — Side-by-Side Configuration Error
Warning
windows-DLL-Missing-dll-not-foundWindows Error DLL-Missing — DLL Not Found
Warning
windows-app-runtime-r6025Windows Runtime Error R6025 — Pure Virtual Function Call
Warning

Frequently Asked Questions

At %LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json. You can also open it from Terminal: Ctrl+, then click 'Open JSON file'.