Skip to content

How-to

Configuring entries

Selected Entry shows the settings for the active Entry List item. Its subsections change with the entry type. This page is the task-focused tour; for every field of every type, 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 / Action

The Value section appears for managed, Custom, and Operator entries:

  • Managed entries configure custom-property defaults and UI metadata. This includes the value types — Float, Integer, Boolean, String, Array, Data-Block (ID Type + default), and Python (a Python-literal value).
  • Custom entries configure the RNA path or internal control source.
  • Operator entries configure operator id, run mode, properties JSON, and notifications.

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

Integer choice modes hide this section

A managed Integer entry set to Choice Dropdown or Choice Toggle hides the Value section, because its Choices list controls the stored integer range instead. See Integer Control.

Integer Control

The Integer Control section appears for integer-valued entries and chooses how the integer is drawn:

  • Control: Number Field, Choice Dropdown, or Choice Toggle.
    • Number Field: a normal Blender integer input.
    • Choice Dropdown: a native enum-style generated menu driven by the ordered Choices.
    • Choice Toggle: exclusive checkbox / toggle-button controls driven by the ordered Choices.
  • Toggle Layout: for Choice Toggle, draw the choices on one row, one row with the label above, or separate rows.
  • Choices: an ordered list you add, remove, duplicate, and move. Row order sets the zero-based stored value (choice 0 → 0, choice 1 → 1, …).
  • Default Choice: which zero-based choice value the managed integer property is created with.
  • Animate Control: for Choice Dropdown / Choice Toggle, optionally draw a native integer Keyframe Field or Number Field beside the choice UI (the wrappers themselves can't be keyframed). Animate Width sets how much of the row it takes.

Choices vs. Dynamic Labels

The Choices list is separate from Dynamic Labels and only defines the stored values and their visible names. Dynamic Labels still only change the entry label — for choice-backed integers they use a From Choice picker and summarize the matching choice.

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 or Label Above for scalar numeric controls.
  • 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. 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.

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).

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