Merges Command

VSTS | TFS 2018 | TFS 2017 | TFS 2015 | VS 2017 | VS 2015 | VS 2013

Displays detailed information about past merges between the specified source and destination branches.

Required Permissions
To use the merges command, you must have the Read permission set to Allow for both source and destination branches. For more information, see Permissions and groups reference.

tf merges [source] destination [/recursive] [/extended] [/format:(brief|deltailed)] [/login:username, [password]] [/showall]]] [/collection:TeamProjectCollectionUrl]





Filters the merge history to include only entries with the specified sources.

This parameter is optional.


Specifies the destination branch for which merge history is displayed.

This parameter is required.


Provides a value to the /login option. You can specify a username value as either DOMAIN<em>UserName or UserName.


The URL of the team project collection that contains the branches about which you want to display the merge history (for example, http://myserver:8080/tfs/DefaultCollection).




Displays information for all merges in specified Team Foundation version control server folder and its subfolders.


Displays a list of merges for a specific range of target items (for example: tf merges tgt\file1.txt; C21-25). This option displays the types of merges (for example, add or edit) and detailed information about the source and target items. This option implies /format: Detailed.

Note You cannot use this option if you have specified a source item.


Specifies the formats in which merge history can appear:

  • Brief: default value, shows the changeset numbers for both the source and target items and the author and the date of the target checkin.

  • Detailed: shows the detailed paths and changeset numbers for both the source and target items.


Specifies the user name and password to authenticate the user with Visual Studio Team Foundation Server.


Displays all past merges for a given target item under its current name and all previously used names.


Specifies the team project collection.


For links to other Team Foundation commands that provide additional information about the items in your Team Foundation version control server and all the workspaces that map to it, see Informational Commands.

For more information on how to find the tf command-line utility, see Tf Command-Line Utility Commands.


The following example displays information about all merge operations performed between Beta1_branch and RTM_branch.

c:\projects>tf merges /recursive Beta1_branch RTM_branch
  • Sample output:

    Changeset  Merged in Changeset   Author   Date
    135         162                   Justin     10/31/2003
    146         162                   Justin      10/31/2003
    147*        167                   Bill       11/02/2003

    The asterisk '*' next to changeset 147 indicates that only some of the changes in that changeset #147 were merged into changeset #167.

See Also


Command-Line Syntax (Version Control)
Merge Command
Branch Command


Informational Commands

Other Resources

Tf Command-Line Utility Commands
Branching and Merging