Create a label#

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 Cloud Dashboard#

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

To create a new label:

1. From the Labels tab, select New label.
2. Enter a Label name.
3. Enter a comment to describe the label.
4. 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.
5. 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:

1. From the Labels tab, select the context menu icon (...).
2. Select Edit permissions.
   • Developer permissions show by default. To edit permissions for a specific user or user group, select Add user/user group.
3. 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.
4. 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.

1. In your workspace, select the Branch Explorer tab.
2. Right-click the changeset you want to label and select Label this changeset.
3. 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.
4. 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#

• delete
• rename