Create a new project
Use Unity Hub to set up a new project from templates and manage template options.
Read time 4 minutesLast updated 8 days ago
To create a project in the Unity Hub, you need an active Unity license associated with your account. The Hub creates and stores projects locally. You can also store projects remotely through Unity Version Control, GitHub, or GitLab.

Create a project from a template
To create a new project, select Projects. The New project window appears:

- Select New project.
- Select the Editor version you want to use . For information on installing a Unity Editor version, refer to Download and install the Unity Editor.
- Choose a project template. Templates are organized into three categories: Core, Sample, and Learning. For more information about each category, refer to Template categories. To learn more about a template, select it and select View details to display more information, including the platforms that the template supports and the Unity packages it installs.
- If a template that you want to use isn't downloaded, select Download template and wait for the download to complete.
- Enter a Project name. The Hub uses this name for the project folder that stores your assets, scenes, and other project files.
- Choose a Location on your device to store the project. By default, the Hub stores projects in your user home directory. To choose a different location, select the Location field and navigate to your preferred folder.
- Optionally select Use Unity CLI to control this project from the command line. This option is available for Unity 6 and later. For more information, refer to Use the Unity command-line interface (CLI).
- Optionally, to create a remote repository for the project, set Source control provider. To learn more, refer to Create a source control repository for a project.
- Select Create project. The Hub creates the project, adds it to your Projects list, and opens it in the Unity Editor.
For more information about the properties in the Projects window, refer to Projects window reference.
Create a source control repository for a project
When you create a new project, you can also create a new repository to connect the project to through Unity Version Control, GitHub or GitLab. To learn how to set up Unity Version Control in the Hub, refer to Get started with Unity Version Control via the Unity Hub.
For GitHub and GitLab, the Hub uses the Git credentials stored in your operating system's credential manager or in Git Credential Manager. You don't need to enter a token in the Hub. For more information about credential settings, refer to Hub settings reference.
Create a GitHub repository in the Unity Hub
To add a new project to a GitHub repository:
- Set Source control provider to GitHub.
- If the credential status displays Not connected, select Sign in. If it displays Configure, select Configure to set up Git Credential Manager.
- Enter a name in the Repository name field.
- Optionally, expand Additional configuration to set the owner, visibility status, description, and a default branch name for your repository.
- Select Create project.
The Hub creates a repository at the location you selected, adds the project to your list, and opens it in the Unity Editor.
Create a GitLab repository in the Unity Hub
To add a new project to a GitLab repository:
- Set Source control provider to GitLab.
- If the credential status displays Not connected, select Sign in. If it displays Configure, select Configure to set up Git Credential Manager.
- Enter a name in the Project name field.
- Optionally, expand Additional configuration to set the User/group, visibility, description, and default branch name for your repository.
- Select Create project.
The Hub creates a repository in the selected GitLab namespace, adds the project to your list, and opens it in the Unity Editor.
Template categories
Project templates provide pre-selected settings based on common best practices for different types of projects. Templates optimize your project settings for specific use cases and platforms.
Note: The available templates depend on the Editor version you select. When you choose a different Editor version, the template list updates to show the templates compatible with that version.
Core templates
Core templates are general-purpose templates for common development scenarios. They include templates for 2D and 3D application development, virtual reality (VR), augmented reality (AR), mixed reality (MR), and mobile platforms. Core templates configure the appropriate render pipeline and packages for the project type you choose.
Sample templates
Sample templates include pre-built scenes, assets, and configurations that demonstrate certain project setups and workflows.
Learning templates
Learning templates include guided tutorials, sample scenes, and assets designed to help you learn the fundamentals of the Unity Editor. For more learning resources, visit the Unity Learn website.
Update a template
If an update is available for a template you already downloaded, its tile displays an upgrade icon. To download the update, select the template, then select Upgrade. You can download the update or continue using the current version of the template.
Check for template updates when you switch Editor versions.