How to change background image on Windows Terminal

You can run Command Prompt, PowerShell, and Linux using a custom background image on Windows Terminal, and here's how.

Windows Terminal background image
Windows Terminal background image

On Windows Terminal, there are multiple ways to customize the experience, you can use custom themes, add transparency, and even set a custom image as the background.

When using the option to change the background, you can add a background image (jpg, png, or gif) to all the apps available in the terminal, or you can set a different background image for Command Prompt, PowerShell, and Linux distros on Windows 11 or 10.

In this guide, you’ll learn the steps to configure an image background for Windows Terminal on Windows 11 or 10.

Change background image on Windows Terminal 

  1. Open Windows Terminal.

  2. Click the menu (down-arrow) button next to a tab.

  3. Select the Settings option.

  4. Under the “Profiles” section, choose the Defaults profile to apply the settings to all the profiles or choose a specific profile, such as Command Prompt.

  5. Under the “Additional settings” section, click the Appearance setting.

    Terminal appearance settings

  6. Click the “Background image path” setting.

  7. Click the Browse button.

    Terminal set background image

  8. Select the image to set as a background.

  9. Click the Open button.

  10. (Optional) Choose the resize preference (Uniform to fill, Uniform, Fill, or None) with the “Background image stretch mode” setting.

  11. (Optional) Click the “Background image alignment” setting to change the background alignment.

  12. (Optional) Use the “Background image opacity” slider to set the opacity of the background.

  13. Click the Save button.

After you complete the steps, the image will appear in the console’s background. 

You can click the reset button next to the setting if you want to reset the settings. Also, remember that changing the settings on a specific profile will take precedence over the settings in the “Defaults” settings.

Change background image from Settings.json on Windows Terminal

To add a background image on the terminal, use these steps:

  1. Open Windows Terminal.

  2. Click the menu (down-arrow) button next to a tab.

  3. Click the Settings option.

    Quick tip: Using Visual Studio Code to open the settings is recommended because it includes the JSON schema, making it easier to change the settings.
  4. Under the “defaults” section, copy and paste the following JSON lines to use a background image in all command line apps:

    "backgroundImage": "PATH/TO/IMAGE-FILE",
    "backgroundImageOpacity": 0.3

    In the code, specify the path and name of the image you want to use. If you want to transfer the settings to another device, you could use OneDrive as the path, so you don’t have to modify the code again on another machine. For example, the following code sets a jpg image stored on OneDrive as the background for Windows Terminal:

    "backgroundImage": "%USERPROFILE%/OneDrive - Family/wt-background.jpg",
    "backgroundImageOpacity": 0.3

    Windows Terminal background image for all apps

  5. Under the list section, select the profile (app) to specify an image file for the background. For example, under "commandline": "cmd.exe" insert a comma (,) at the end of the line, and copy and paste the following lines:

    "backgroundImage": "PATH/TO/IMAGE-FILE",
    "backgroundImageOpacity": 0.3

    Windows Terminal background image for Command Prompt

  6. (Optional) In the "backgroundImageOpacity": settings change the value of selecting the transparency level. For example, 0.6 will make the background less transparent, and 0.4 will make the background more transparent.

  7. (Optional) You can use the "backgroundImageStretchMode": setting to stretch the image depending on its dimensions. Options available include: fill, none, uniform, or uniformToFill.

  8. (Optional) You can use the "backgroundImageAlignment": setting to align the image. Options available include: bottom, bottomLeft, bottomRight, center, left, right, top, topLeft, and topRight.

  9. Save the file to apply the changes.

Once you complete the steps, you can start using the Windows Terminal with a custom image background for a specific app or all the command line apps depending on your configuration.

About the author

Mauro Huculak is a Windows How-To Expert who started Pureinfotech in 2010 as an independent online publication. He has also been a Windows Central contributor for nearly a decade. Mauro has over 14 years of experience writing comprehensive guides and creating professional videos about Windows and software, including Android and Linux. Before becoming a technology writer, he was an IT administrator for seven years. In total, Mauro has over 20 years of combined experience in technology. Throughout his career, he achieved different professional certifications from Microsoft (MSCA), Cisco (CCNP), VMware (VCP), and CompTIA (A+ and Network+), and he has been recognized as a Microsoft MVP for many years. You can follow him on X (Twitter), YouTube, LinkedIn and Email him at [email protected].