Promoting files

Promote individual files from a child branch to a parent branch when you need to make sure the most recent copy is available in the parent branch.

You can also promote branches to retrieve all files with changes to a parent branch. See Promoting branches.

You cannot promote files from a snapshot branch. Snapshot branches are static and cannot contain differences.

1. Select the files to promote and choose Branch > Promote File.

The Promote Files dialog box opens.

2. Select an Ancestor to promote to.

3. Enter any Comments, such as the reason for promoting the files.

4. Select a Promote files based on option.

  • Latest version promotes the latest version of each file.
  • Timestamp promotes changes from the specified timestamp.
  • Label promotes changes from the selected label. Click Select to view label details or search for a label. See Selecting labels. Labels on files in the parent branch are not copied to the child branch.
  • Latest version in state promotes changes from the latest version of each file in the selected workflow state.
  • Snapshot promotes changes from the selected snapshot branch.

5. Select Skip server auto-merge to promote changes and overwrite changes in the parent branch.

6. Select Recursive to promote the file to the selected repository and all subrepositories.

7. Click Preview.

The Promote Preview dialog box opens. Files that will be promoted, files that will not be promoted, and files with conflicts are displayed. You can perform actions and resolve conflicts based on the file status and your security permissions. See Promote preview.

8. Select a file and click Promote File to promote it or click Promote All to promote all files.

The Promote Status dialog box opens. You can perform many of the same actions available in the Promote Preview dialog box.

9. Click Close when you finish.