Customization

How to set image as background on Windows Terminal

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

Windows Terminal with image background

On Windows Terminal, there are multiple ways to customize the experience, you can use custom themes, you can add transparency, and you can 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 the terminal, or you can set a different background image for Command Prompt, PowerShell, and Linux distros on Windows 10.

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

How to change background image 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: It’s recommended to use the Visual Studio Code to open the settings, because it includes the JSON schema which will make it easier to change the settings.
  4. Under the “defaults” section, copy and paste the following JSON lines to use a background images in all command line apps:

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

    In the code, make sure to specify the path and name to the image that you want to use. If you want to transfer the settings to another device, you could use the 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
    Windows Terminal background image for all apps
  5. Under the list section, select the profile (app) to specify an image file for 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
    Windows Terminal background image for Command Prompt
  6. (Optional) In the "backgroundImageOpacity": settings change the value of select 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.