Pop-up Dialog Editor¶
Pop-up Dialog creates a small popup UI from buttons, properties, sliders, and checkboxes arranged in rows and columns. Unlike Pie Menu and Regular Menu, it lets you design the layout yourself.
Configuration guide — features, combinations, and uses (for AI)
Name: Popup Dialog / Type ID: DIALOG. Combines actions and settings in rows and columns, displayed as a dialog or popup. Supports Command / Property / Menu / Hotkey / Custom with additional rows and columns.
Assignments: Property provides an RNA-path widget, Command executes Python, and Custom draws using Blender’s
UILayout.Menu combinations: open other menus or expand Regular Menu / Popup Dialog contents. Property / Property Stack references place settings widgets.
Placement: open from a hotkey, expand inside a Pie Menu, or extend an existing Panel / Header. Distinguish the dialog’s own settings from width and position on the referencing slot.
Design: decide row/column layout separately from popup Mode. Check opening the UI and executing its buttons in the target context separately.
See layout for rows and columns, Extend Target for insertion, and Advanced settings for display options.
Interface and editing workflow¶
1Name and basic controlsCheck the name and enabled state, and open the preview or advanced settings.
2Extend TargetChoose an existing panel or header to extend. No target is selected in this example.
3Advanced settingsSet the description, availability conditions, display mode, width, and property layout.
4Keymap / HotkeyChoose where and with which key to invoke it.
5Menu slotsArrange display settings in rows and columns. Use the controls at the right of each row and item to edit them.
Set the name, availability, and invocation method, then build the contents with slots.
Name and basic controls¶
Controls include enabled state, preview, menu selection, name, tags, documentation, and advanced settings. See selected menu settings.
Keymap / Hotkey¶
Keymap selects where the dialog is available; Hotkey sets the key and modifiers. Open Mode determines the trigger action. See the shared Hotkey settings.
Extend Target¶
Example with TOPBAR_HT_upper_bar as the destination.¶
The row below the top bar inserts this Pop-up Dialog into an existing Blender panel or header.
Added in version 2.0.0: Redesigned Extend Panel / Extend Header so multiple Pop-up Dialogs / Regular Menus can share a Target.
- Extend Target:
Destination Blender class ID, with search. Paste the string obtained through Interactive Panels’ Copy Panel ID. When unset, the dialog works as an ordinary hotkey-invoked popup.
- Side:
Insertion position. Prepend adds at the start; Append adds at the end. The image uses left and right triangle buttons.
- R:
Appears only for
TOPBAR_HT_targets and toggles insertion into the TOPBAR header’s right region.- Order:
Display order for menus sharing a Target. Lower values draw first.
See Interactive Panels and Extend Panel for the insertion workflow.
Advanced settings¶
Description and Poll set the tooltip and availability. Dynamic Python descriptions are also supported. See the shared advanced settings.
Added in version 2.1: Property Split aligns labels and input fields. In addition to the whole-menu setting, individual items can override it.
Property Split separates property names from values; Property Decorators controls animation-related decorations.
Display modes¶

Choose one of three modes for the popup’s appearance and closing behavior.
Mode |
Pie |
Dialog |
Popup |
|---|---|---|---|
Closes when the mouse leaves the popup |
❌ |
❌ |
✅ |
Closes after interacting with a widget |
✅ |
❌ |
❌ |
OK button |
❌ |
✅ |
❌ |
Movable |
❌ |
✅ |
✅ |
Customizable width |
❌ |
✅ |
✅ |
Layout¶
Build a Pop-up Dialog UI with Blender’s row-and-column layout system.
Slots become widgets such as buttons or properties. Split rows into columns and add subcolumns or subrows as needed. Adding, removing, and reordering slots changes the popup layout.

In the editor, divide a row into columns, then add subcolumns and subrows as needed.
To add a subcolumn, open an item’s menu with LMB and select the Column separator. Use Begin Subrow and End Subrow in the menu to add subrows inside a column.
A Custom slot can use Python layout APIs directly to draw widgets in place of a default button.
This video by original author roaoao demonstrates combining rows and columns. Its UI is from an older version, but it shows how to build a complex layout.
Popup Dialog with Complex Layout
Expand the layout in a parent popup¶

When a Pie Menu or Pop-up Dialog slot references this dialog, choose between opening a separate popup and expanding its layout in the calling menu. Enable Expand Popup Dialog in the calling slot’s Menu tab for expansion.
Fixed columns¶

Fixed Columns gives columns equal widths. It does not set a width in pixels.
Alignment¶

For an unsplit row without columns, choose left, center, or right horizontal button alignment.
Embedded panels and link controls¶
Added in version 2.0.5: Added collapsible panels and editor link-button visibility settings. Embedded panels require Blender 4.2 or later.
A. Panel Row embeds another Pop-up Dialog as a collapsible panel. “Display As” references the dialog used for its contents. Use the body for target and initial-state settings and the rightmost panel icon for whole-row actions.
B: ordinary Menu slot: Editor Link Buttons controls button visibility. Even when off, Go to Linked Menu remains available in the slot action menu.
C: Panel Row body: the link button is always shown. Go to Panel Content is also available in the body menu. Navigation is unavailable if the reference is invalid.
Advanced uses¶
A temporary alternative to the N-Panel¶
Collect settings in a Pop-up Dialog and invoke it by hotkey to keep them available without a permanent N-Panel presence. Property and Custom slots can use Blender’s standard widgets directly.
Draw an existing Blender panel in Custom¶
Use the panel() helper in a Custom slot’s Python layout code to embed native Blender panels. template_* widgets can also be used.
panel("VIEW3D_PT_view3d_properties", frame=True, header=True)
template_list() needs both the collection and an Int property storing the selected item index. Use an existing RNA property on the target or define your own.
Insert with Extend Panel / Extend Header¶
Set Extend Target to insert this Pop-up Dialog’s contents into an existing Blender panel or header. See Interactive Panels and Extend Panel.
Open a Blender editor area with popup_area¶
Separate from Pop-up Dialog Editor, popup_area opens an actual Blender editor area—such as Properties, Outliner, or Asset Browser—in a temporary popup window. Use it when you want an existing editor instead of building a layout yourself.
bpy.ops.pme.popup_area(area='PROPERTIES', width=600, height=800)
bpy.ops.pme.popup_area(area='ASSETS', width=1000, center=False, height=800)