All content in this course uses:

Project setup processes

This is a guide through common processes you may need to set-up a Unity project to complete one of our tutorials.

This is a collection of common processes for project setup. You may be directed here from other learning experiences if you need to recap one of these processes.

Before you begin to set up your Unity project, consider updating your Unity Hub to the latest general (non-beta) release. 

If you are using a beta version of the Hub, you may find minor differences between the process guidance here and your experience. 

Overview and Unity Hub version

The easiest way to install the Unity Editor is to use the Unity Hub. For instructions on how to install the Hub, refer to 

To install a new version of the Unity Editor using the Unity Hub, follow these instructions:

tab shows you all of the Unity versions that you already have installed on this computer.

  In most cases, you'll want to select the most recent long-term support (LTS) version of the editor, as listed on the 

 list. Find the version you need and select 

 window appears, listing add-on modules for the Unity version you selected.

  Select any modules that you want to add. Categories include the following:

, such as Microsoft Visual Studio Community, for code editing in Unity.

, which allows the experiences you create to be played on different platforms (WebGL, Windows, Mac and Linux).

, an offline version of the Unity Manual for your chosen Unity version.

You might be prompted to accept additional terms and conditions for certain modules.

When you’ve completed this process, return to your learning experience.

If you see any errors while the new version of Unity is downloading, consider the following tips and workarounds:

Do you have enough memory and disk space?

Check the minimum system requirements for the Unity version you are installing

 to make sure your computer is ready. Locate the dropdown menu in the upper-left corner of the “System requirements” page to find the right Unity version. 

 If you aren’t planning to do any scripting with this version of the Editor, disable the option to download “Microsoft Visual Studio Community” tools (or a similar option). This will save disk space and avoid possible errors.

Check the release information page for this version.

, and use the dropdown at the top of the page to select the version you are installing. Look for any known issues that might be causing your problem. If absolutely necessary, you can use these pages to download a version of the Unity Editor without using the Hub.

 for more help. Be sure to sign in on the Support pages. Browse articles, consult the community, or select 

 to explain your situation to a Unity expert. 

Install a version of the Unity Editor from the Hub

You can add modules to a Unity version after you have installed it. 

: Make sure you save and close any open Unity projects before installing new modules for a Unity version that you are using.

To add modules to any Unity version you have installed, follow these instructions:

 on the tile of the version you want to manage, and select 

Select any modules that you want to add. Categories include the following:

You might be prompted to accept additional terms and conditions for certain modules. 

Add modules to an installed Unity version

You might load Unity projects onto your computer from .zip files, version control software, or the Asset Store. Follow these instructions to add a project from your computer to the Unity Hub so that it is listed on the 

: If the file path to a project on your computer is more than 260 characters long, or if there are spaces in that file path, you might encounter errors when you initially open your project from Unity Hub. To avoid encountering these errors, we recommend that you do one or more of the following:

Check that the folder you are organizing your Unity projects in isn’t at the end of a long file path. 

Remove any spaces from the folder names in the file path to your Unity projects.

Name your project without spaces. You can use underscores (_) if this is helpful. 

To add a Unity project to the Unity Hub, follow these instructions:

 Navigate to the root folder for the Unity project and then 

The project will appear in the list available on your 

If the project uses a Unity version that you don’t have installed, you’ll see a warning in the 

To fix this, you can do one of the following:

and open the project using a newer Unity version that you have installed previously. 

: When you open the project, you'll be prompted to confirm that you want to upgrade the project to a different Unity version. 

: Don’t open any Unity project with an older Unity version — this is known as downgrading.

When you’ve completed this process, return to your learning experience. 

Add a project to the Unity Hub

To create a new Unity project, follow these instructions:

Select the Unity version you’d like to use with the 

  Select the template that you want to use. 

In most Learn tutorials, we'll instruct you on the right template to choose for your learning experience.

If you see the download icon (cloud with a down arrow), you’ll need to download the template or update it before you can use it. 

Name your project and set the location for saving the project on your computer. 

Select the organization the project should be associated with. 

Organizations are created and managed in your Unity Account Dashboard. You can create your own organization or be assigned to an existing one by an organization administrator.

Select whether or not the project should be connected to the 

Unity Cloud is an ecosystem of products and services that makes work on games and real-time 3D experiences more creator-focused, accessible, and connected.

Select whether or not Unity Version Control should be used for the project. Unity Version Control allows you to collaborate remotely on the same project with up to three people on the Unity Personal plan. 

After the Unity Hub downloads and installs all the files, your project will open in the Unity Editor.

Depending on the template you select, you might see sample content. If you don’t want to use this content, you can create a new scene and select from different scene templates; for example, the Basic URP option that contains only a Directional Light and Main Camera. 

For instructions on creating a new scene, continue to the step below.

Create a new Unity project

Follow these instructions to create a new scene in any project:

The available scene templates will depend on the project template you chose. If you are unsure which one to use, the Basic (URP) or Basic (HDRP) scene templates are probably the best choice. In the image below, you can see the scene templates that are available in the 3D (URP) project template. 

.  Give your new scene a name and select a location to save it. 

folder inside your project is the best option to keep everything neat and easy to manage. 

) in the Hierarchy. If you chose a scene template other than the Basic one, you may have additional objects in the Hierarchy. These GameObjects also have icons that represent them in the scene. You can adjust the size of the icons or switch them off by using the Gizmo visibility toggle in the upperright corner of the 

If you wish to keep the Gizmos but adjust their size, open the 

Create a new scene

To install a package, follow these instructions:

  Open the Unity Editor, if you haven’t already done so.

Browse the Unity Registry (default view) or use the search bar to find the package that you want to install.

 When you’ve found your required package, select 

   Remember to save your changes by selecting 

Install a package via the Package Manager

To add a new Unity package by name, follow these instructions :

  Select the Add (+) menu in the upper-left corner of the Package Manager and select 

Enter the name of the Unity package you wish to add. 

This name is always in the format of com.unity.packagename. Optionally, you can add the version number of the package you wish to download. If you leave this empty, the latest version will be installed.

 When you’ve completed this process, return to your learning experience. 

Install a Unity package by name

 To update a package in your Unity project, follow these instructions: 

 view lists all the packages that are currently in your Unity project.

  Select the relevant package from the list available. 

: An arrow icon indicates packages with an update available.   

Update a package in your Unity project

To import assets into your project from the Unity Asset Store, follow these instructions:

 and find the package you want to download.

  When the completion dialog window opens, select 

If you previously downloaded the assets, you will go straight to the next step in this process. 

   A dialog window will warn you about overwriting your project settings — if you haven't customized your project settings, you can ignore this warning. To proceed, select

  Another dialog might warn you that there are Package Manager dependencies — if so, select 

 window will open, listing the contents of the package. In most cases, you will want to keep all of the contents of the asset package selected.


  In the lower right corner of the window, select 

folder of your Unity project. When this process is completed, close the 

 window and return to your learning experience.

: This is the basic set-up process. If you are importing assets into a complicated project, you can review 

 for a more detailed overview of the options available.  

Import assets from the Asset Store

To import a local asset package into your project, follow these instructions:

  In the file browser window, navigate to the .unitypackage file you want to import and select 

You can find these assets by going to the 

 for a more detailed overview of the options available in this process.  

Import a local asset package

To import individual simple assets into a Unity project, follow these instructions:

 In your file browser window, navigate to the file that you want to import.

  Drag the file from the file browser into the 

This will copy the file into the Unity project’s 

: You can also save or export files directly to that 

 in the Asset workflow section of the Unity Manual

 for a more detailed overview of importing files into Unity projects. Importing more complex assets that require configuration requires a different process. If you need to do this, you will be guided through it step by step in your specific learning experience. 

Import individual assets from your computer

: This guidance is included for completeness, but we do not recommend you download learning projects using this process. Your specific learning experience will guide you on the best approach.


To open a project from the Learn tab in the Unity Hub, follow these instructions:

 Find and select your chosen learning content from the list available.

  If the content contains a downloadable Unity project, select 

The Unity Editor will open, import the project, and update any necessary 

 to save your version of the project. Alternatively, you can use the shortcut 

Open projects from the Learn tab in the Unity Hub

: This guidance is included for completeness, but we do not recommend you download learning projects via the Unity Hub. Your specific learning experience will guide you on the best approach.

If you have opened a project via the Learn tab of Unity Hub, save it using the following steps:

  Save your project using your operating system’s saving window.

Choose an easily accessible location for your project, such as a dedicated Projects folder or your Documents folder.

  Once the project is saved, re-open the Unity Hub. 

tab in the Hub and open it in the Unity Editor.  

Save a project opened via the Learn tab in Unity Hub

If you want to change the contrast between the default background and primitives with the default material, follow these instructions to change the background color:

skybox, fog, and various other effects toggle

 property. Use the color picker for this property to choose the background color that suits you.  

property in the same way to adjust the color of the grid. 

: To return to the usual default sky in the Scene view, select the 

skybox, fog and various other effects toggle

Unity Version 2022.3