Unity UI System Selector

Helps you choose the appropriate UI system for your Unity project and provides implementation guidance for both UGUI and UI Toolkit.

Two UI Systems

UGUI (Legacy) - GameObject-based (2014). Mature, works on all Unity versions, large community. Weaker: Complex UI performance, limited styling, no live reload.

UI Toolkit (Modern) - Retained mode, web-inspired UXML/USS (2021.2+). Better performance, live reload, data-binding. Weaker: Requires 2021.2+, smaller community, limited 3D world-space UI.

Decision Framework

Use UGUI if:

• Unity < 2021.2

• Simple UI (menus, HUD)

• 3D world-space UI needed

• Team knows UGUI well / tight deadline

• Legacy project

Use UI Toolkit if:

• Unity 2021.2+ and new project (future-proof)

• Complex/data-driven UI (inventory, skill trees)

• Editor tools (inspectors, windows) - strongly recommended

• Web dev background (HTML/CSS)

• Large-scale UI (MMO, strategy games)

When in doubt: For new projects on Unity 2021.2+, UI Toolkit is recommended.

Comparison

Feature UGUI UI Toolkit

Version 4.6+ 2021.2+

Performance Simple UIs All UIs

Styling Inspector CSS-like USS

Layout Manual/Groups Flexbox-like

Editor Tools Good Excellent

Runtime UI Excellent Good

3D World UI Excellent Limited

Migration

See migration-guide.md for UGUI → UI Toolkit migration strategy (3-4 months for medium projects).

UI System Support Matrix

Unity Version UGUI UI Toolkit (Editor) UI Toolkit (Runtime)

2019.4 LTS ✅ Full ✅ Basic ❌ No

2020.3 LTS ✅ Full ✅ Good ⚠️ Experimental

2021.3 LTS ✅ Full ✅ Excellent ✅ Production

2022.3 LTS+ ✅ Full ✅ Primary ✅ Full

When to Use vs Other Components

Use this Skill when: Choosing between UGUI and UI Toolkit, understanding UI system trade-offs, or planning UI migration

Use @unity-scripter agent when: Implementing UI components, writing custom UI scripts, or converting UI code

Use @unity-architect agent when: Designing complex UI architecture, planning UI data flow, or structuring large-scale UI systems

Use /unity:new-script command when: Generating Editor scripts with UI Toolkit or UGUI templates

Related Skills

• unity-uitoolkit: Assists with UI Toolkit implementation (UXML, USS, VisualElement API)

• unity-template-generator: Generates Editor scripts using selected UI system

• unity-script-validator: Validates UI code patterns