Unity Version Control: Quick start guide

1. Overview

Unity Version Control (UVCS) is a scalable, engine-agnostic version control management tool built for 3D project development. With both centralized and distributed workflows and superior speed handling large files and binaries, artists and programmers alike can work the way they need to.

2. Open the Unity Hub and connect to Unity Version Control

To connect Unity Version Control (UVCS) to a new Unity project, open the Hub and select the Use Unity Version Control button from the New project window. To connect UVCS to an existing project, select the More (⋯) menu in the Project window and select Use Unity Version Control.

3. Enter your Unity Version Control information to create a repository

Once you have enabled Unity Version Control in your project, you will be prompted to fill out three sections:

• Unity Version Control Organization: This will populate if you are already connected to your Unity ID.

• Repository: This will populate a repository name synced with your project name.

• Server location: This populates based on the Unity Version Control Organization your account is associated with. UVCS selects the closest available server, based on your IP address.

Note: ​​The choice to select the server location is only available when the UVCS organization is created. If the UVCS organization has already been created, the choice to select server location is unavailable.

This step creates a repository, which is used to store the local copies of your project files. This allows you to check in (commit) changes to the repository.

4. Create a workspace

Select where you want to store your project files on your local disk to create a workspace.

5. Open the Unity Version Control window in the Unity Editor

Once you have connected UVCS to a new or existing project, open the project and select the UVCS tab in the Project window to open the Unity Version Control window (the location of the Unity Version Control window might differ based on your Editor version). Alternatively, select Window > Unity Version Control to display the UVCS window in the Editor.

6. Next steps

Great job! Now you’re ready to start using Unity Version Control. If you need more help getting started, visit the Unity DevOps Learn course, or check out our documentation.

We also have a Unity Version Control course on our on-demand training platform if you want to take your learning to the next level.