2018-10-19 12:39:22 -07:00

2.4 KiB

title
Plugin Icon

Beginning in version 2018.3, the IntelliJ Platform supports representing a plugin with an icon. A Plugin Icon is intended to be a unique representation of a plugin's functionality, technology, or company.

Plugin Icons are shown in the Settings/Preferences Plugin Manager UI in JetBrains' products. Plugin Icons also appear in the Plugins Repository, and also in MarketPlace.

Note: icons and images that are used within a plugin have different requirements. See Working with Icons and Images for more information.

Plugin Icon File Format

All Plugin Icon images must be provided in SVG format. Plugin Icons will be displayed in 40px by 40px and 80px by 80px size. However, only one size icon should be supplied because the will automatically scale.

Icon Size Example SVG Icon
40x40 Kotlin Plugin Icon

Plugin Icon File Naming Convention

Plugin Icon files are named according to the following conventions:

  • pluginIcon.svg for use with the default (light) JetBrains IDE theme
  • pluginIcon_dark.svg for use with the Darcula JetBrains IDE theme

Adding Plugin Icons to a Plugin Project

The Plugin Icon files must be in the META-INF folder of the plugin distribution file, i.e. the *.jar or *.zip file you upload to the plugin repository and install into a JetBrains IDE.

To include Plugin Icons in your distribution file, place the Plugin Icon files into a plugin project's resources/META-INF folder. Note this requirement is the same regardless of using DevKit or Gradle for developing a plugin. For example:

Plugin Icons in META-INF folder

Plugin Icons API

If you need access to existing Plugin Icons you can acquire them through the Plugin Repository using the following URL format:
https://plugins.jetbrains.com/api/icon?pluginId=${PLUGIN_XMLID}&theme=${DEFAULT|DARCULA} Note thetheme parameter may be omitted when you are retrieving an icon for a DEFAULT theme.

An example URL to retrieve the Fortran Plugin Icon would be:
https://plugins.jetbrains.com/api/icon?pluginId=org.jetbrains.fortran&theme=DEFAULT