It has always bugged me that Blender add-ons (in this case the Sapling add-on for generating trees) have a wall socket as their icon in the Add menu, instead of something more custom. I would like to be able to set this icon for these add-ons and for the scripts that I write.

Is it possible to change this icon, either through a custom build of Blender, or by modifying the Python script in any way?

For existing addons you'll have to find its code and change the code where operators are added to menus.

When you write your own add-on, you can choose a different icon by specifying the icon parameter to the operator function with which you register your operator in a function.

From the Mesh Add operator template in the Blender text editor the snippet:

def menu_func(self, context):


For a list of icons to choose from see the blender documention. There are many places where you can define an icon, but there is only one list. For instance for the menu function of a layout. It takes an icon, the list is the same.

Icons outside these are not (yet) supported. You can replace the entire icon set though by specifying an icon file at the bottom of the User Interface section of the theme editing in User Preferences

• is there a reason the icon path dialog is gone in 2.68a? Or has it just moved someplace else? – Haunt_House Aug 14 '13 at 21:07
• That looks like a bug. – jesterKing Aug 16 '13 at 22:14
• Bug report is filed and closed. The Icon thing isn't working yet so the hiding of the field is intentional. – Haunt_House Aug 17 '13 at 19:53

To see all the available icons embedded in Blender (and therefore accessible to any addon) you can use the Icon Enumerator Addon.

Often I turn to this post on BlenderArtists by HansPKG, who assembled an image of most icons and their reference names

The blender wiki page Dev:2.5/Doc/How to/Add an icon has a thorough description of how to add icons of your own, this is currently possible only when you do your own Blender builds.

• Nice add about building Blender. Didn't really think of that (as Q was about addons). – jesterKing Jun 28 '13 at 17:00
• would be neat to be able to load a small raster image as custom icons, it's one of the few areas in Blender that isn't easily customizable. – zeffii Jun 28 '13 at 17:03