Editing labels

You can edit a label to rename it, change the branches it is available in, or remove it from files.

You can change the branches that a label is available in (scope) based on the following rules:

If the label is not applied to any files, the availability can be changed to the mainline branch or a selected branch in the mainline branch.
If the label is available and applied to files in a specific branch, the availability can only be changed to the mainline branch.
If the label is available in the mainline branch and applied to files in one child branch, the availability can only be changed to that child branch.
If the label is available in the mainline branch and applied to files in more than one child branch, the availability cannot be changed.

1. Select the mainline branch that includes the label.

2. Choose Tools > Labels.

The Labels dialog box opens.

3. Select a label and click Edit.

The Edit Label dialog box opens. A progress indicator may open if the label is applied to several files.

4. Make any changes.

5. Click the Files tab to view the files the label is applied to.

Select a file and click Remove to remove the label from it. See Removing labels from files.

Use the Repository/Filename Search field to limit the file list to filenames and repositories that contain the text you enter. Searches are not case sensitive and cannot include wildcard characters.

6. Click the History tab to view the label history. See Viewing label history.

7. Click OK to save the changes.