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:
-
Sign in to the Unity Dashboard.
-
Select Development.
-
Under Shortcuts, select Version Control.If Version Control isn't under Shortcuts, select the + icon next to Shortcuts, then select Version Control.
-
Select Repositories.
Find and create repositories
You can do the following tasks on the Repositories page:
Task | How |
|---|---|
| Find a repository | Enter its name in the search box. |
| Check how much storage a repository uses | Check 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 repository | Select 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 repository | In the General tab, select the edit icon next to Repository name. |
| Copy the repository GUID | In the General tab, select the copy icon next to Repository GUID. |
| Turn email notifications on or off | In 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 rules | In 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 mergebot | Select the Mergebots tab. For more information, refer to Create a mergebot. |
| Connect mergebots to a CI system or a notification service | Select 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 repository | In 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.
Task | Tab | More information |
|---|---|---|
| Browse, download, and preview files | File explorer | File explorer reference |
| View locked files | File locks | Smart Locks, Lock rules |
| Request, read, and merge code reviews | Code reviews | Navigate code reviews |
| Find branches and request reviews of them | Branches | Branches tab |
| Find, compare, label, and delete changesets | Changesets | Changesets tab |
| Find and create labels | Labels | Labels tab |
| Mark branches, changesets, or labels with metadata | Attributes | Create an attribute |