Warning

This is a simple port from the original documentation. It will be improved in the future.

Pop-up Dialog

Pop-up Dialog Editor allows you to create a layout of widgets that can be displayed in pie menus, dialogs, panels or toolbars.

Mode

Affects the appearance and behavior of the pop-up.

Mode	Pie	Dialog	Popup
Moving the mouse outside the pop-up closes it	❌	❌	✓
Interaction with widgets of the pop-up closes it	✓	❌	❌
OK button	❌	✓	❌
Movable	❌	✓	✓
Customizable width	❌	✓	✓

Hotkeys

Button Hotkeys

LMB	Open Menu
Ctrl+LMB	Add Button to the Right
Ctrl+Shift+LMB	Add Button to the Left
Ctrl+Alt+LMB	Remove Button
Shift+LMB	Edit Button
Alt+LMB	Change Icon
Alt+OS+LMB	Clear Icon
Alt+Shift+LMB	Hide Text
OS+LMB	Toggle Spacer
Ctrl+OS+LMB	Copy Button
Ctrl+Shift+OS+LMB	Paste Button

Row Button Hotkeys

LMB	Open Menu
Ctrl+LMB	Add Row Below
Ctrl+Shift+LMB	Add Row Above
Shift+LMB	Toggle Row Size
OS+LMB	Toggle Row Spacer

Layout

Blender uses row/column based layout system. The editor allows you to set-up a column of rows with optional sub-columns and sub-rows.

In order to add a sub-column, use LMB on one of the buttons to open a menu and select Column separator. To add a sub-row to the sub-column there are Begin Subrow and End Subrow entries in the menu.

If you need more options to control the layout you can write python code in Custom tab which will be used to draw custom layout of widgets instead of default button.

Expand Layout

To expand layout inside pie menus or another popup dialog you need to enable Expand Popup Dialog option in Menu tab.

Fixed Columns

By default Blender resizes columns depending on the number of buttons in sub-rows. You can enable Fixed Columns option to fix that.

Alignment

You can adjust the alignment of buttons if there are no columns in the current row.