Interface
Panels, menus, buttons and fields: everything your add-on shows in Blender.
The interface nodes build what users see: a panel in the sidebar, a menu, a preferences page, or entries added to Blender's own menus. A root node (Panel, Menu, Pie Menu, Preferences, Add to Menu, ...) starts an interface flow, and the nodes connected after it draw from top to bottom. Find them under Add › Interface, the layout nodes under Add › Interface › Layouts and the icon nodes under Add › Interface › Icons.
Where it's drawn
| Node | Does |
|---|---|
| Panel | A panel in an editor's sidebar, the Properties editor or another region |
| Subpanel | A collapsible section inside a panel |
| Popover | A button opening a panel as a popup |
| Menu | A dropdown button and the menu it opens |
| Pie Menu | A menu around the mouse, opened with a shortcut |
| Open Menu | Opens a menu, pie menu or panel at the mouse from a flow |
| Operator Menu | One entry per item of an operator's enum property |
| Menu Contents | Draws the entries of a menu in place |
| Add to Menu | Draws into one of Blender's menus |
| Add to Panel | Draws into one of Blender's panels |
| Add to Header | Draws into an editor's header |
| Preferences | The add-on's settings in Preferences › Add-ons |
| Redraw | Redraws editors so panels show new values |
Layout
| Node | Does |
|---|---|
| Row | Draws its contents side by side |
| Column | Draws its contents below each other |
| Box | A framed column |
| Split | Two columns with a set share of the width |
| Grid | Fills its contents into a grid |
| Separator | Space or a line |
| Set Layout State | Grays out or highlights what follows, sets how buttons run |
| Set Layout Scale | Makes what follows bigger, or a fixed size |
| Set Property Layout | Labels next to fields and keyframe dots, like Blender's panels |
| Reset Layout | Continues in the panel's own layout, outside rows and boxes |
| Set Context Data | Gives buttons after it data their operator reads from context |
| Progress | A progress bar or ring |
| Display Preview | The rendered preview of a material, texture, light or world |
Lists
| Node | Does |
|---|---|
| UI List | Blender's list widget for a collection, with a selected item |
| Draw For Each | Draws its flow once per item of a list or collection |
Fields and buttons
| Node | Does |
|---|---|
| Button | A button that runs an operator |
| Checkbox | A Boolean property as a checkbox or toggle |
| Number Field | An Integer or Float property |
| Text Field | A String property as a field, text box or search field |
| Vector Field | A vector or color property |
| Enum Menu | An Enum property as a dropdown, buttons or icon previews |
| Pointer Field | A Pointer property, or Blender's data-block selector |
Text
| Node | Does |
|---|---|
| Label | A line of text with an optional icon |
| Multiline Label | Text wrapped over several lines |
| Markdown | Text formatted with markdown |
| Link | A link that opens a web page |
Icons
| Node | Does |
|---|---|
| Icon | One of Blender's icons |
| Custom Icon | An image as icon, shipped with the add-on |
| Display Icon | Draws an icon on its own, at any size |
| Icon from Data | The icon Blender shows for data or an enum item |