Documentation

Unity Version Control

Manage repositories

Open, find, and create Unity Version Control repositories in the Unity Dashboard, and find the repository tab for each task.
Read time 3 minutesLast updated 2 hours ago

A Unity Version Control repository stores your files and their revision history. Each repository belongs to a project in your Unity organization, and each project can contain multiple repositories. A repository can contain one or more Unity Editor projects. Access to a repository follows the permissions of its organization and project. For more information, refer to User types, roles, and permissions.
The following diagram shows a Unity organization with one project that contains two repositories. Repository A contains one Unity Editor project, and Repository B contains two.

Open the Repositories page

To open the Repositories page:
  1. Sign in to the Unity Dashboard.
  2. Select Development.
  3. Under Shortcuts, select Version Control.
    If Version Control isn't under Shortcuts, select the + icon next to Shortcuts, then select Version Control.
  4. Select Repositories.

Find and create repositories

You can do the following tasks on the Repositories page:

Task

How

Find a repositoryEnter its name in the search box.
Check how much storage a repository usesCheck the Storage used column. On Overview, the Storage used per repository card also shows storage, with a View all link and the Total project storage used at the bottom.
Create a repositorySelect New repository. For more information, refer to Create a repository.

Change repository settings

To open the settings of a repository, open the repository, then select Settings.
You can do the following tasks on the Repository settings page:

Task

How

Rename the repositoryIn the General tab, select the edit icon next to Repository name.
Copy the repository GUIDIn the General tab, select the copy icon next to Repository GUID.
Turn email notifications on or offIn the General tab, select the edit icon next to Email notifications. Notifications tell you when someone mentions you, or updates a code review that's relevant to you.
Manage lock rules or merge rulesIn the General tab, under Repository rules, select the link for lock rules or merge rules. For more information, refer to Lock rules and Create merge rules.
Set up a mergebotSelect the Mergebots tab. For more information, refer to Create a mergebot.
Connect mergebots to a CI system or a notification serviceSelect the Mergebot integrations tab, then select New mergebot integration and select the service, such as Jenkins or Slack. For more information, refer to Advanced settings.
Archive the repositoryIn the General tab, under Danger Zone, select Archive repository. Unity Version Control deletes an archived repository after 7 days. Until then, you can restore it from the Archived tab of the Repositories page.

Work in a repository

When you open a repository, use its tabs to do the following tasks.
Tip
A changeset is a set of changes that you check in to the repository together.

Task

Tab

More information

Browse, download, and preview filesFile explorerFile explorer reference
View locked filesFile locksSmart Locks, Lock rules
Request, read, and merge code reviewsCode reviewsNavigate code reviews
Find branches and request reviews of themBranchesBranches tab
Find, compare, label, and delete changesetsChangesetsChangesets tab
Find and create labelsLabelsLabels tab
Mark branches, changesets, or labels with metadataAttributesCreate an attribute

Additional resources