PyCharm 2024.1 Help

Background image

You can set any image as a custom background for the editor and all tool windows in PyCharm. Configuring an image is possible when you have a project opened.

Configure a custom background image

  1. Open a project in PyCharm.

  2. Press Ctrl+Alt+S to open settings and then select Appearance & Behavior | Appearance.

  3. Click the Background Image button.

    The Background Image button in Appearance settings
  4. In the Background Image dialog, specify the image you want to use as the background and click OK to apply the changes.

    The Background Image dialog

    For more information about the options, refer to Background image settings.

Background image settings

The Background Image dialog has the following options:


Either specify a local path to an image in your file system or a URL to an image on a remote server.


Specify the relative opacity of the image, where 100 is completely opaque and 0 is completely transparent.

Placement options

Use the icons to select where to place the image:

  • Mirror the image vertically or horizontally

  • Select whether to place one copy of the image at its original size, scale the image to fit the entire width, or fill the entire width with copies of the image at its original size

  • If you choose to keep the original size, select where to put the image: in the center, on a side, or in a corner.

This project only

Select if you want to use this custom image as a background only in the current project.

Editor and Tools

Configure an image to be used as the background of the editor and tool windows.

Empty Frame

Configure an image to be used as the background when no files are open in the editor.

Clear and Close

Clear the background image and use the default background.

Last modified: 22 March 2024