Create a label

Create and edit labels in your repository.

Read time 2 minutes

Last updated 10 months ago

A label is a name you can define and attach to a changeset. This means you can assign a name to the current version of every file within your workspace as of a specific changeset.

Create a label in the Unity Dashboard

You can create a new label from the Labels tab of your repository in the Unity Dashboard. You can also view, rename and delete existing labels.

To create a new label:

From the Labels tab, select New label.
Enter a Label name.
Enter a comment to describe the label.
Select the changeset to associate with your label.
- You can also select Label all writable xlinked repositories to apply the label to all the repositories connected to the current repository.
Select Save to save your label.

Edit label permissions

Labels inherit the permission settings from the changeset that you apply them to. You can edit and override these object permissions for a specific label:

From the Labels tab, select the context menu icon (...).
Select Edit permissions.
- Developer permissions show by default. To edit permissions for a specific user or user group, select Add user/user group.
In the Permissions dropdown menu, select or deselect the permissions you want. To change an inherited permission, you need to select the Override toggle first.
Select out of the Permissions dropdown menu and select Save.

Create a label in the GUI

A label is a name you can define and attach to a changeset. This means you can assign a name to the current version of every file within your workspace as of a specific changeset. You can use a label to rebuild the status later if you need to.

In your workspace, select the Branch Explorer tab.
Right-click the changeset you want to label and select Label this changeset.
Configure the label.
1. Enter the label name.
2. Enter a comment to describe the label.
3. Optionally, check Label all writable xlinked repositories to apply the label to all linked repositories.
Select Label.

UVCS marks labeled changesets with a circle. You can right-click the circle to access additional label options.

Create a label in the CLI

To manage your labels, use the

cm label

command. If the label doesn’t already exist, the command creates the label and applies it to the changeset you specify.

For example, you can use the following command:


cm label BL002 cs:1203 -c="first release"

Additional commands

Create a label in the Unity Dashboard

You can create a new label from the Labels tab of your repository in the Unity Dashboard. You can also view, rename and delete existing labels.

To create a new label:

From the Labels tab, select New label.

Enter a Label name.

Enter a comment to describe the label.

Select the changeset to associate with your label.

You can also select Label all writable xlinked repositories to apply the label to all the repositories connected to the current repository.

Select Save to save your label.

Edit label permissions

Labels inherit the permission settings from the changeset that you apply them to. You can edit and override these object permissions for a specific label:

From the Labels tab, select the context menu icon (...).

Select Edit permissions.

Developer permissions show by default. To edit permissions for a specific user or user group, select Add user/user group.

In the Permissions dropdown menu, select or deselect the permissions you want. To change an inherited permission, you need to select the Override toggle first.

Select out of the Permissions dropdown menu and select Save.

Create a label in the GUI

In your workspace, select the Branch Explorer tab.

Right-click the changeset you want to label and select Label this changeset.

Configure the label.

Enter the label name.
Enter a comment to describe the label.
Optionally, check Label all writable xlinked repositories to apply the label to all linked repositories.

Select Label.

UVCS marks labeled changesets with a circle. You can right-click the circle to access additional label options.

Documentation

Development

User Acquisition

Monetization

Industry

Unity Version Control

DevOps

On-prem

Gluon

Editor plug-in

Unity Version Control

Create a label

Create a label in the Unity Dashboard

Edit label permissions

Create a label in the GUI

Create a label in the CLI

Additional commands

Documentation

Development

User Acquisition

Monetization

Industry

Unity Version Control

DevOps

On-prem

Gluon

Editor plug-in

Unity Version Control

Create a label

Create a label in the Unity Dashboard

Edit label permissions

Create a label in the GUI

Create a label in the CLI

Additional commands