uGUI or UI Toolkit: which to build your game's UI in
Unity ships two UI systems and the internet will tell you the new one wins. It is not that simple: one of them is still what Unity recommends for runtime, and the other is where the development is going. Here is how to choose without betting the project on a forum post.
In this article
Open to new projects
Hadjoudj Idris
Game UI/UX Designer
Upwork100% Job Success
Hire me Browse the workThis question usually arrives at the worst possible moment: a week before UI production starts, from an engineer who has read that uGUI is legacy, in a project where nobody has time to be wrong. The honest answer is that both systems are viable in 2026, they are good at different things, and the cost of choosing badly is a rebuild rather than a disaster.
The short answer
| If your game is | Build in |
|---|---|
| A HUD-heavy action game with keyframed interface animation | uGUI |
| Menu-heavy and data-driven: strategy, management, RPG inventories | UI Toolkit |
| Small, on a deadline, with a team that already knows uGUI | uGUI |
| Live with frequent content updates and a large screen count | UI Toolkit |
| VR, AR or anything with interface in the world | Either, and read the world-space section below |
| Already half built in one of them | The one it is already in |
If that table settled it, stop reading and go build. The rest is for the projects where it did not.
What the two systems actually are
The difference is not cosmetic, it is architectural, and it explains every trade-off that follows.
- uGUI builds interface out of GameObjects. A button is an object in the scene with an Image, a Button and a Text component on it. You author it in the scene view, you see it while you place it, and everything you already know about prefabs, the Inspector and the Animator applies to it.
- UI Toolkit builds interface out of a retained visual tree, authored as UXML and styled with USS, which are close relatives of HTML and CSS. Elements are not GameObjects. You author in UI Builder rather than the scene, and you style with selectors that apply across the whole project instead of setting values object by object.
So uGUI feels like the rest of Unity, and UI Toolkit feels like the web. Which of those your team finds natural is a real input to the decision, not a soft one.
What Unity itself says
Worth checking directly, because it surprises people. In the Unity 6 manual's comparison of UI systems, for runtime UI, uGUI is the recommended system and UI Toolkit is listed as the alternative. For Editor tooling it is the other way round: UI Toolkit is recommended and IMGUI is the alternative.
The same page then splits it by use case, and that split is more useful than the headline:
| Use case | Unity's pick |
|---|---|
| Multi-resolution menus and HUD in intensive UI projects | UI Toolkit |
| World-space UI and VR | UI Toolkit |
| UI that requires customised shaders and materials | UI Toolkit |
| UI that requires keyframed animations | uGUI |
And it lists the features each one does not have. UI Toolkit has no in-scene authoring, no serialized events, and no integration with Animation Clips and Timeline. uGUI has no data binding system, no textureless elements and no SVG support.
Where uGUI still wins
- In-scene authoring. You place interface in the scene, at the scale it will exist, next to the thing it belongs to. For world-space panels and for anyone who thinks visually, this is a genuinely large advantage.
- Animation Clips, the Animator and Timeline. If your interface has keyframed motion, cutscene-driven UI, or anything authored on a timeline, this is the system that supports it directly. This alone decides a lot of action games.
- Serialized events. Wiring a button to a method in the Inspector is how most Unity teams already work, and it keeps designers able to connect things without an engineer.
- Fifteen years of ecosystem. Every asset, every tutorial, every Stack Overflow answer, every contractor. When you hire someone for two weeks, uGUI is what they will already know.
- Everything else in your project already works this way. Prefabs, prefab variants, layers, sorting, physics raycasts, your existing tooling.
Where UI Toolkit wins
- Styling at scale. USS selectors mean a change to a colour, a corner radius or a type scale happens once and lands everywhere. In uGUI the equivalent is a theming system you have to build yourself, and most teams do not.
- Heavy, data-driven screens. Runtime data binding connects UI elements to game data without a wall of boilerplate, and virtualised lists handle thousands of rows without instantiating thousands of objects.
- Performance under element count. Unity 6 brought jobified mesh generation, parallelised text generation and much faster event dispatch. On a screen with hundreds of elements this is a real difference, and it is exactly where uGUI's canvas rebuilds hurt, as covered in why your Unity menus tank the frame rate.
- Custom shaders, materials, vector graphics and textureless elements. Backgrounds, gradients and shapes that cost you an atlas slot in uGUI cost you nothing here.
- It is where the development is. uGUI is stable and maintained; UI Toolkit is where new features land. Over a five-year live game that gap compounds.
The hybrid most teams land on
The two systems coexist in one project, and this is not a compromise, it is often the correct architecture. The split follows the strengths above almost exactly.
| Surface | System | Why |
|---|---|---|
| Front end, settings, inventory, shop, codex | UI Toolkit | Data-heavy, list-heavy, style-heavy, rarely keyframed |
| Gameplay HUD | uGUI | Animator-driven feedback, tight coupling to gameplay objects, world anchoring |
| Damage numbers, nameplates, world markers | uGUI | They live in the scene and follow objects |
| Diegetic screens on in-world objects | Either | See world-space UI in Unity |
The cost of the hybrid is real and worth naming: two sets of components, two styling systems, two ways of doing states, and a design system that has to be expressed twice. Budget for that rather than discovering it. If your game is small, one system for everything is usually cheaper than the perfect split.
What changes for the designer
This is the part that rarely gets discussed, and it changes what a handoff has to contain. The design work is the same. The deliverable is not.
| Design concept | In uGUI | In UI Toolkit |
|---|---|---|
| Component library | Prefabs and prefab variants | UXML templates plus USS classes |
| Design tokens | A theming system somebody builds | USS variables, defined once |
| States | Sprite swaps, a Selectable transition, or an Animator | Pseudo-classes: hover, active, checked, disabled |
| Layout | Anchors, and layout groups where needed | Flexbox: direction, grow, shrink, wrap |
| Spacing scale | Numbers typed into RectTransforms | A class applied to elements |
| Responsive behaviour | Anchors plus Canvas Scaler | Percentage units, flex, and media-style breakpoints |
The practical consequence: on a UI Toolkit project the handoff should be a style sheet and a component spec, and on a uGUI project it should be annotated screens plus a prefab structure. Handing a Unity team the wrong one is how a design gets reinterpreted. The full package for each is in designing game UI for Unity.
Both systems will render your design. Only one of them will let your team change it in a year without opening every screen.
Migration: what it actually costs
Porting an existing uGUI interface to UI Toolkit is not a conversion, it is a rebuild with a reference. Nothing transfers automatically: no prefabs, no Animator states, no serialized event wiring, no scripts that touch RectTransforms.
- The design survives. Layouts, hierarchy, spacing and art all carry over conceptually, which is the majority of the thinking.
- The assets mostly survive. Sprites and atlases are used by both, and some backgrounds can be deleted entirely once USS can draw them.
- The wiring does not. Every button hookup, every animation, every script that reaches into the hierarchy needs redoing.
- Budget by screen count, not by ambition. A rough rule from projects I have seen: a straightforward screen is half a day to rebuild, a systems screen with lists and states is two to three days.
- Do not migrate mid-production. The two moments that work are before UI production starts, and between major releases on a live game.
Five questions that decide it
- 01
Does your interface have keyframed animation?
If cutscenes, Timeline or Animation Clips drive interface, uGUI is the direct path. Motion in UI Toolkit is done with transitions and code, which is fine for menu polish and awkward for authored sequences.
- 02
How many elements are on your busiest screen?
Dozens, either works. Hundreds, or a list of thousands, UI Toolkit's virtualisation and batching pull ahead sharply.
- 03
Who maintains it, and for how long?
A six-month project with contract engineers favours what they already know. A live game with years of content favours the system with styling at scale.
- 04
How much of the interface lives in the world?
Both handle world space now, but if most of your UI is anchored to scene objects, uGUI's in-scene authoring is a workflow advantage every single day.
- 05
What does your team actually know?
The most overlooked input. A team fluent in uGUI shipping in nine months will beat the same team learning a new system, no matter which one is technically better.
Is uGUI deprecated?
No. It is stable and still the system Unity's own manual recommends for runtime UI, while active development happens on UI Toolkit. Practically that means uGUI is safe to ship on today and unlikely to gain much, and UI Toolkit is where new capability appears. Neither of those facts should panic a team mid-project.
Which is faster?
It depends on what you are drawing. UI Toolkit generally scales better with element count, and Unity 6 added jobified mesh generation, parallel text generation and faster event dispatch. uGUI's problems are usually canvas rebuilds rather than raw draw cost, and a well-structured uGUI screen can beat a badly structured UI Toolkit one. Structure decides more than the system does.
Can I use both in the same project?
Yes, and many teams do: UI Toolkit for menus and data screens, uGUI for the HUD and anything anchored in the scene. The cost is maintaining two component sets and expressing your design system twice, so it is worth doing deliberately rather than by accident.
Does UI Toolkit work for world-space UI and VR?
Unity's current comparison page lists world-space UI and VR under UI Toolkit, which is a change from a few years ago when uGUI was the only realistic option. uGUI still gives you in-scene authoring and Animator support, which matter a lot for interface attached to scene objects. Check the manual for your exact Unity version before committing, and see world-space UI in Unity for the design side.
Do designers need to learn UXML and USS?
Not to design, but it helps enormously to understand them, in the same way understanding anchors helps on a uGUI project. If you know CSS you already know most of USS. The practical benefit is that your handoff can name selectors and classes rather than describing appearances, which is the difference between a design that is implemented and one that is interpreted.
We are starting a new project next month. Which one?
If it is menu-heavy, data-driven, or intended to live for years, start in UI Toolkit. If it is HUD-heavy, animation-heavy, small, or your team is already fluent in uGUI, start in uGUI. If you cannot decide, prototype one real screen in each over two days. The team's reaction to those two days is better evidence than any article, including this one.
Does the choice change what UI design costs?
Not the design itself, which is the same thinking either way. It changes the handoff and the implementation support: a UI Toolkit project wants a style sheet and component specs, a uGUI project wants annotated screens and a prefab structure. Where it does affect cost is maintenance, since restyling a UI Toolkit game is dramatically cheaper. The general pricing logic is in the cost article.
Hadjoudj Idris
Game UI/UX Designer, Remote, worldwide
Need this done properly on your game?
Menus, HUDs, a full UI system, or one screen that isn't working. Tell me what you're building and I'll tell you honestly whether I'm the right fit, and what it would cost.
Upwork100% Job Success