Docs
Download

Panels

Add panels to the 3D Viewport's sidebar, the Properties editor and other editors.

A Panel node (Add › Interface › Panel) adds a panel to Blender, like the Transform panel in the 3D Viewport's sidebar. The nodes connected to its Draw output are the panel's contents, drawn from top to bottom. A new Panel shows up in the 3D Viewport's sidebar (press N), in a tab with your add-on's name.

The Object Tools panel in the 3D Viewport's sidebar, with a row of two buttons and a Display subpanel, next to its nodes

Making a panel

Add a Panel node and type the panel's title into Label.

Connect what it should show to Draw: a Button, a field for a property, a Label. Connect the next node to the output of the previous one, and each draws below the one before.

Open the 3D Viewport's sidebar (N) and click the tab with your add-on's name. The panel updates while you edit the nodes.

To put things side by side or in boxes, use the layout nodes.

Where a panel goes

Every panel in Blender lives in a place made of three parts:

PartWhat it isExamples
SpaceThe editorView 3D (the 3D Viewport), Properties, Node Editor, Image Editor
RegionThe part of the editorUi is the sidebar (N panel), Window the main area, Header the header (popovers only)
ContextOnly in the Properties editor: its tabObject, Material, Render, Scene, World

So a panel in the Object tab of the Properties editor is Space Properties, Region Window, Context Object. The default is the 3D Viewport's sidebar: Space View 3D, Region Ui.

There are two ways to set the place:

  • Pick it. Click the eyedropper on the node. Every place in Blender that can hold a panel gets a red Pick This Location button (in sidebars, under a Pick Location tab). Go to the editor you want and click it. Cancel Picker on the node stops picking.
  • Set it. Click Settings on the node, open Location and choose the space, region and context from the dropdowns. They list every place where Blender or an add-on has a panel.

The sidebar tab

Sidebar panels sit in a tab. Settings › Tab is the tab's name; empty uses your add-on's name (from the add-on settings). Panels with the same tab name share a tab, also with Blender's: type Item or Tool to add your panel to those tabs.

The Panel's Icon input is the icon of the sidebar tab, shown when Blender draws the tabs as icons (Blender 5.2 and later; older versions ignore it). It's only there for sidebar panels.

Panel settings

Settings on the node opens a popup with everything that isn't an input:

SettingDoes
Default ClosedThe panel starts collapsed
Hide HeaderNo title bar: the panel can't be collapsed or dragged, its contents sit directly in the region
OrderSorts the panel among others in the same place: higher values go lower
TabThe sidebar tab (Region Ui only), see above
LocationSpace, region and context, see above

Inputs and outputs

Socket
LabelThe panel's title
Is VisibleShows the panel only while it's True, e.g. only when the active object is a mesh. Connect a condition to it
IconThe sidebar tab's icon
HeaderDraws into the title bar, next to the title. Things drawn here sit in a row, e.g. a checkbox that turns a feature on, like Ambient Occlusion in the render settings
DrawThe panel's contents

Is Visible is checked often while Blender draws, so keep what's connected to it fast and free of side effects.

Subpanels

A Subpanel (Add › Interface › Subpanel) is a collapsible section inside a panel, like Delta Transform inside Transform.

Socket
Default ClosedThe section starts collapsed
HeaderThe section's title bar. A subpanel has no title of its own: connect a Label here
PanelThe contents, drawn while the section is open
AfterContinues below the subpanel

Blender remembers per subpanel whether it's open, by an id made from the node's label (F2, or Label in the sidebar's Node tab) and unique within the add-on.

A subpanel works directly in a panel's layout (or after other nodes in it), not inside rows, columns or boxes.

Panels elsewhere

  • Popover draws a button that opens a panel as a popup, see Menus.
  • Open Menu and a Shortcut set to open a menu can open a panel at the mouse too.
  • To add contents to one of Blender's existing panels instead of making a new one, use Add to Panel.

Redrawing

Blender redraws a panel when the mouse moves over it and when a property it shows changes. Values that change without that, from a timer, a handler or a variable, can stay outdated until the next redraw. Put a Redraw node (Add › Interface › Redraw) in the flow after the change. Its Editors dropdown picks the editor type to redraw, All Editors by default.

Limitations

  • A panel's place is fixed when the add-on registers. To show it only sometimes, use Is Visible.
  • Drawing runs many times per second. Don't change data in a panel's flow (Set Property, operators that edit data): Blender doesn't allow it there and shows an error. Use a Button that runs an operator instead.
  • Only places that already hold a panel in Blender are offered in the location dropdowns and the picker.