Docs
Download

Icons

Put Blender's icons or your own images on labels, buttons, fields and menus.

Every node that draws text has an Icon input: click the button on it to search Blender's icons. For your own images, an object's type icon or a large logo, use the icon nodes in Add › Interface › Icons.

A panel with a built-in icon, an icon from the Icon node, the active object's icon, a custom icon and the custom icon drawn large, next to their nodes

Where icons go

These nodes have an Icon input: Label, Multiline Label, Link, Button, Operator Menu, Menu, Popover, Panel, the fields (Checkbox, Number Field, Text Field, Vector Field, Enum Menu, Pointer Field) and Enum Item.

An icon on a label, button or field is always the size of the text. To draw one larger, use Display Icon.

Icon nodes

Node
IconOne of Blender's icons, picked on the node. Connect it to several nodes that should share an icon
Custom IconAn image as an icon. Pick an image or open an image file on the node; it's copied into the add-on's icons/ folder and loaded when the add-on first needs it
Icon from DataThe icon Blender shows for data. With Source Data: the icon of the connected Data, e.g. an object's type icon or a material's preview. With Source Enum Item: the icon of an item of an enum property: Data is what holds the property, Property its Python name and Item the item's identifier. Without data (no active object) it's no icon
Display IconDraws an icon on its own, Scale times as big (3 is three times). For a logo from a Custom Icon or a large preview from Icon from Data. Blender's own icons don't get bigger: they're drawn at their normal size in the middle of the larger space

Connected icons are icon ids, the numbers Blender's icon_value arguments take. You can also connect an Integer with an icon id, or a String with an icon's name ("MESH_DATA").

Limitations

  • Custom Icon needs the image's file: pack the image (Image › Pack) or keep its file where the .blend can find it. An image painted in Blender and never saved can't be used. Editing the image file doesn't rebuild the add-on; change something in the tree or reload.
  • The image ships as it is. Blender scales it down for the icon, so use a small square image (32 or 64 pixels).
  • Blender's icons are stored by name. An icon this Blender doesn't have (renamed or removed in another version) is an error on the node.
  • Enum items listed with a property (sidebar Properties) only take Blender's icons. For custom icons in a dropdown, use an Items Function with Enum Item nodes (see Properties).
  • A Panel's icon is the icon of its sidebar tab, shown instead of the tab's name with Compact Tabs (right-click the tabs). Only panels in a sidebar have tabs. Blender 5.2 added it; older versions ignore it. When several panels share a tab, give them the same icon. For an icon in the panel's header, draw a Label with an icon in the Header flow.