How to Use Unity Hub: Manage Unity Projects and Versions Easily

Use Unity Hub to install and manage multiple Unity versions and projects in one place. Open Unity Hub, install desired Unity editors, create or open projects, and switch between versions easily.

Syntax

Unity Hub is a desktop application, so it does not have code syntax but a user interface with key parts:

• Installs: Manage Unity Editor versions.
• Projects: Create, open, and organize your Unity projects.
• Learn: Access tutorials and sample projects.
• Settings: Configure preferences like license and editor paths.

You use buttons and menus to perform actions like installing editors or creating projects.

unity

Unity Hub UI Components:
- Installs: Add or remove Unity Editor versions
- Projects: List of your Unity projects
- Create Project: Start a new Unity project
- Open Project: Open an existing project
- Settings: Manage licenses and preferences

Example

This example shows how to create a new Unity project using Unity Hub:

1. Open Unity Hub.
2. Click Create in the Projects tab.
3. Choose a Unity version from the installed editors.
4. Enter a project name and select a location on your computer.
5. Pick a template (e.g., 3D, 2D).
6. Click Create to start the project.

Unity Hub will open the Unity Editor with your new project ready to work on.

unity

Steps to create a new project in Unity Hub:
1. Open Unity Hub
2. Click 'Create'
3. Select Unity version
4. Name your project
5. Choose project location
6. Select template (3D, 2D, etc.)
7. Click 'Create'

Unity Editor launches with the new project.

Output

Unity Editor window opens with your new project ready for development.

Common Pitfalls

Common mistakes when using Unity Hub include:

• Not installing the required Unity Editor version before opening a project, causing errors.
• Creating projects without selecting the correct template, leading to unexpected project setup.
• Forgetting to activate a Unity license in Unity Hub, which can block editor usage.
• Opening projects with mismatched Unity versions, which may cause compatibility issues.

Always check your installed editors and license status before starting work.

unity

Wrong way:
- Trying to open a project with no matching Unity Editor installed.

Right way:
- Install the required Unity Editor version via Unity Hub before opening the project.

Wrong way:
- Creating a project without selecting a template.

Right way:
- Always pick a template (3D, 2D, etc.) when creating a project.

Quick Reference

Action	How to do it in Unity Hub
Install Unity Editor	Go to Installs tab → Click 'Add' → Select version → Install
Create New Project	Go to Projects tab → Click 'Create' → Choose version, name, template → Create
Open Existing Project	Go to Projects tab → Click 'Add' → Browse to project folder → Open
Switch Unity Version for Project	Select project → Click three dots → Choose 'Add Unity Version' or change version
Manage License	Click Settings (gear icon) → License Management → Activate or return license

Key Takeaways

Use Unity Hub to manage multiple Unity Editor versions and projects easily.

Always install the correct Unity Editor version before opening or creating projects.

Select the right project template to match your game type (2D, 3D, etc.).

Keep your Unity license activated in Unity Hub to avoid interruptions.

Use the Projects tab to organize and quickly access your Unity projects.