User Icons

File Icons

This is a file, identified by its name (per example, foo.py) or, generally, its full path (per example, /home/me/prj/foo.py). The "\" characters are replaced by "/" even on Windows. Names and paths are lowercased.

Directory Icons

This is a directory, identified by its name (per example, dir) or, generally, its full path (per example, /home/me/prj/dir). The "\" characters are replaced by "/" even on Windows. Names and paths are lowercased.

IDE Icons

This is an icon of the IDE, like an icon in a menu, a toolbar, a tool window, etc. This can also be the icon for a file type (per example, for Java classes).

In this situation, the Model dialog is a bit different, as it will ask for the IDE icon path (the Icon's name field), and there won't be a list of conditions:

An icon is identified by its name (per example, GrazieCloudProcessing.svg) or its internal path (per example, /icons/stroke/GrazieCloudProcessing.svg).

Find IDE Icon Names

You can find IDE icon names or paths by enabling the Internal Mode of your IDE:

1. Go to `Help > Edit Custom Properties...` then add `idea.is.internal=true`.

2. Restart your IDE.

3. You can now use the UI Inspector with this combination: `Ctrl` + `Alt` + clicking on an element in the IDE. This will open a dialog showing information about the element. Click `icon` to get the icon path.

In this example, I clicked on the VCS icon of the main toolbar.

Here, the icon path is /expui/general/vcs.svg. If you override only vcs.svg, you will actually override all the icons with a path that ends with vcs.svg.

Menu Action Icons

This is an icon associated with an action in a menu. For example, you can add an icon to the right-click > Git > Rebase... action. You can also overwrite an action's icon if it already has one.

For icons associated with intermediate menus, JetBrains does not allow that. If you're interested in this missing feature, please upvote IDEA-364676.

Conditions

When defining a model for a File or a Directory, you will define one or many conditions under which the icon override will apply.

When defining multiple conditions in the table, the icon override will apply if at least one condition is matched.

Inside a condition (i.e., in the Add Condition dialog), you will define one or many rules. When defining multiple rules, the condition will apply if all the rules are verified.

1. The file or folder path verifies the given regular expression.

2. The file or folder has the given folder name as parent.

3. The file or folder name starts with or is equal to the given string. You can also indicate the file or folder path shouldn't contain a "." character.

4. The filename ends with the given string. This rule can be made optional (enable May end with instead of End with).

5. The project or the module has the given facets. You can find the active facets in the Project Structure menu of the IDE.