Skip to content

Building the UI

Cleanup & diagnostics

PropUI gives you targeted tools to clean up custom properties and to inspect what it has stored — without touching your authored work.

Diagnostics

The Diagnostics section appears when PropUI has recent warnings. It is meant for recoverable issues: missing targets, invalid data, import/export problems, and generated-UI lifecycle problems.

Related tools:

  • Clear PropUI Warnings: clears the current warning list.
  • Audit Blend Data: scans the current .blend for PropUI setup data, generated scripts, generated slots, and related records.
  • Verbose Console Diagnostics: an add-on preference that prints debug-level diagnostics and tracebacks to Blender's system console.

Use a diagnostic's details button to read and copy the retained message.

Blend File Inspection

Open Editor Settings → JSON → Blend File Inspection for checks and compatibility repair:

  • Validate Setup checks source paths, dropdown choices, Control Groups, operators and hierarchy without changing the design. Reveal Entry selects a reported entry in PropUI. Validate Setup is also in Entry Tools.
  • Audit Blend Data inspects saved PropUI data in the current file.
  • Repair Geometry Nodes Paths previews supported repairs to older Custom controls whose modifier-input links changed between Blender versions.

Geometry Nodes repair changes the saved PropUI link. It preserves entry labels, identities and layout, leaves drivers alone, and does not rebuild the node graph. Confirm the preview to apply unambiguous compatible replacements, then regenerate the panel or rig. Missing/ambiguous inputs, changed types and old Boolean attribute toggles need manual review. Large previews show eight rows per page; confirmation applies the complete compatible set.

Creation tools for Bone Collection controls and Control Group actions are in Entry Tools beside the Entry List.

Clean Property Storage

Removes custom properties from the default Property Storage target:

  • Managed Only: remove only Property IDs managed by the current setup.
  • Unmanaged Only: remove custom properties not managed by the current setup.
  • Selected Entry: remove only the active Entry List entry's managed property.
  • All Custom Properties: remove every custom property except Blender/PropUI internal data.

Clean Override Targets

Applies the Managed Only, Unmanaged Only, and All Custom Properties modes to entry-specific override targets instead of the default storage. (Selected Entry applies to the default Property Storage above.)

What cleanup does not touch

These tools affect custom properties on Blender data owners only. They do not delete Entry List entries, Generated Layout rows, UI Variants, or generated scripts.

Resetting the editor

If you want to start over, the Reset izom PropUI controls in editor settings range from clearing the current setup to a full factory reset. See Editor settings → Reset.