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