Skip to content

Building the UI

Configuring entries

Selected Entry shows the settings for the active Entry List item. Its subsections change with the entry type. For every field and option, see the Entry type reference.

Basics

Common to most entries:

  • Parent: the current parent entry, with a clear button when parented.
  • Type: the entry type.
  • Editor Label: editor-only list name. It does not affect generated UI labels or custom-property IDs.
  • Label / Text / Button Text: the generated UI text (varies by type).
  • Description: generated tooltip where supported. Leave it empty for no generated tooltip.
  • Property ID: the managed custom-property key (any managed entry type).

Input limits

Field Max length
Property ID 63
Label / Editor Label 255
Tooltip 512

Generated UI tooltip text is additionally clamped for Blender UI safety.

Value / Source / Action

The subsection follows the selected entry type:

  • Managed entries configure custom-property defaults and UI metadata. This includes the value types — Float, Integer, Boolean, Dropdown, String, Array, Data-Block (ID Type + default), and Python (a Python-literal value).
  • Source on Custom entries configures an existing RNA path or internal control. Copy Path and Use Copied Path help repair bindings.
  • Action on Operator entries configures an operator or built-in action, run mode, properties JSON and notifications.

Copy paths and operators straight from Blender

  • Custom path: right-click a supported property and choose Add to PropUI, or use Copy Full Data Path → Entry Tools → Add from Copied Data Path. See Capture existing controls.
  • Operator id: enable Preferences → Interface → Developer Extras, then right-click an operator → Copy Python Command → paste it into the Operator ID / Call field.

The exact fields per type are in the Entry type reference.

Display

Common display controls (availability depends on type):

  • Alert Style: draw the row with Blender alert styling.
  • Slider: draw numeric values as sliders where supported. Cannot be active at the same time as Use Soft Limits — turning one on turns the other off.
  • Label Layout: One Row, One Row with Split Label, or Label Above.
  • Compact Layout: keep a control at its natural width.
  • Native Popover / Foldout: collapse or open an individual control.
  • Multi-Component Layout: layout for arrays and vector/color values.
  • Draw Mode: Native Control or Component Fields.
  • Component Labels: generated labels for component fields.
  • Style: checkbox or toggle button for booleans.
  • Icon pickers: pick Blender icons, with a search button beside the field. Icon changes are normal undoable entry edits. Toggle buttons default to no icon.

When Label Above is active you also get:

  • Use Text-entry style for the detached label.
  • Label Above Style: alignment, alert, before/after icons, and icon hug controls.

See Labels, popovers & foldouts for popup launchers, keyframe buttons, multiline strings and text links. To add shared Reset, Key or value-preset buttons, use Control Groups & actions.

Dynamic Labels

Dynamic labels change the visible label/text depending on values — a deep topic with its own page:

Dynamic labels & conditions

Conditions

The Conditions subsection appears only when the active entry has a parent. It controls child availability and visibility based on the parent's value, and includes Copy Conditions tools to reuse those settings on siblings or children. Also covered on the dynamic & conditions page:

Conditions

Storage

The Storage subsection appears for managed entries:

  • Target Override: choose Property Storage (the Output Setup default) or a specific owner target for this entry.
  • Override target picker: the same target kinds as Output Setup.
  • library_overridable: make the custom property library-overridable where Blender supports it.

Per-entry overrides let one generated panel drive custom properties on multiple data owners. See Property Storage.

Tools

Per-entry default, preset, and copy actions (the Tools section, shown unless hidden in Editor Layout):

  • Save / Apply / Reset My [Type] Default: manage your saved default for that entry type.
  • Copy To All Same-Type Entries: copy compatible settings to all peers of the same type.
  • Copy From Same-Type Entry: copy from a chosen same-type entry.
  • Export / Import / Copy / Paste Entry Preset: move a selected-entry type preset as JSON (file or clipboard).

These tools retain the destination entry's identity, parenting and Custom source binding while copying compatible settings, including the new display options.

For Display Links, the tools include:

  • Reset to Source Settings: copy compatible display/settings from the linked source.
  • Reset to Source Type Default: reset using the linked source entry's type default.

Selected Entry Tools — type defaults, copy settings, and presets