Widget Blueprint Auditor

Module: Tech · Category: Performance · Tool ID: WidgetBlueprintAuditor

Project-wide UMG audit. Scans every UWidgetBlueprint for: deep nesting (>10 levels), excessive bindings (per-frame evaluations), high widget count (>100 per BP), tick-enabled widgets, invisible-but-active widgets with bindings (an easy-to-miss perf issue). CSV export for UI team review.

Auditor after scan, mixed Critical / Warning / Good widget BPs visible with column for each metric.

When to use it

• UI performance pass: finding the widgets eating frame time
• Tick-enabled UMG audit: usually a bug
• Invisible-but-active widget hunting: they still consume binding cost
• Pre-shipping UMG cleanup

What it isn’t for

• Don’t expect runtime UMG profiling. See Runtime Insights for that.
• Don’t expect this to fix issues. Surfaces; per-BP fixes happen in the WBP editor.

Opening the tool

1. Open the EQLabs Hub and search for Widget Auditor (or browse to Tech → Performance).
2. Click the tool card.
3. Click Scan.

Interface tour

Field	What it does
Scan	Walks every UWidgetBlueprint
Search	Filter by name
Problems Only	Hide healthy BPs
Export CSV	Saves the audit
Copy Results	Plain-text dump
Stats	Total Widget BPs / problematic count
Results list	Per-BP row: name, widget count, max depth, binding count, ticking widgets, invisible-active count, severity, issue text

Severity coding

Severity	Meaning
Good	Within thresholds
Warning	Crossed at least one threshold
Critical	Multiple severe issues

Workflow

1. Click Scan.
2. Toggle Problems Only to focus.
3. Sort by severity / metric of interest.
4. Single-click pings the WBP; double-click opens it in the UMG editor.

Output

• In-panel widget BP list.
• CSV export
• Clipboard. Copy Results.

Tips and gotchas

• Tick-enabled UMG widgets are almost always a bug. UMG ticks per-frame; refactor to event-driven.
• Bindings cost per-frame evaluation. High binding counts add up. Replace with event-driven updates where possible.
• Deep nesting (>10) often indicates an authoring problem. Splitting into multiple WBPs improves clarity and perf.

Related tools

• Runtime Insights Suite — runtime UMG perf
• Blueprint Inspector — broader BP complexity