# Managing labels

Labels can be used to mark important file revisions, for example, the set of file revisions used to build a particular software release. You can use labels to specify groups of related file revisions in operations like sync and integrate.

To use labels, you (1) define the label, then (2) label file revisions in the depot. When you define a label, you specify a label view, which limits the files to which the label can be applied.

To create a label:

1. Choose File>New>Label.... The Label form is displayed.
2. Enter a name for the new label.
3. Enter a description of the label.
4. Specify the label view one of two ways:

- Graphically: on the View tab, select depot paths, or
- Textually: on the Form tab, specify the depot location of the files in the View field.

5. Click Save.

To label files:

1. Select a file and choose File>Label... The Label Files dialog is displayed.
2. Browse for the label you want to use from the Label field.
3. Choose the label and click OK.
4. Click the Apply selected label to files radio button.
5. To specify which revision of the files to label, use the At pulldown menu to choose Revision, Changelist, Date/Time, or Workspace. Enter the corresponding information in the field next to the selection. To use the latest revision of the files, select Revision and click the Latest Revision radio button.
6. Click Label.

The selected file must be in the label view and synced to your client workspace.

To remove a label from a set of files:

1. Select a file and choose File>Label... The Label Files dialog is displayed.
2. Browse for the label you want to use from the Label field.
3. Choose the Remove selected label from files option.
4. Click Label.

To display the labels defined for the server to which you are connected, choose View>Labels.

To display the file revisions in a label, context-click the label and choose Show the list of files.

To edit a label:

1. Context-click the label and choose Edit Label labelname. The Label form is displayed.
2. Enter your changes, and click Save.

Editing a label does not change the list of files to which the label is applied.

To delete a label, click the label and choose Edit>Delete Label labelname. Deleting a label also removes the label from files.

To get labeled file revisions into your workspace:

1. Context-click a label, a file, or a folder and choose Get Revision... The Get Revision dialog is displayed.
2. In the Specify the file revision field, choose Label from the pull-down list and browse for the label.
3. Choose the desired label from the list of labels and click OK
4. Click Get Revision to get the file revisions to which the label has been applied into your workspace.