Manage documents and document libraries
TFS 2018 | TFS 2017 | TFS 2015 | TFS 2013
Excel reports, Reporting Services reports, and SharePoint dashboards are only supported for on-premises TFS. For information on what is supported for VSTS, see Dashboards, charts, & widgets.
TFS 2018 and later versions no longer support native integration with SharePoint products. If you're planning to upgrade to TFS 2018, read About SharePoint integration to learn about the options available to you.
You can share documents and files that you want to make available to all team members by uploading them to the project portal for your team project. You can create document libraries and organize the files that you upload to your project portal within those libraries, in addition to folders and subfolders. The folders and subfolders always appear in alphabetical order.
Your team project's Documents page displays all the project portal document libraries as its child nodes. These nodes are the same names that appear when you click Documents in the project portal. The Documents node is another view of the document libraries on the project portal.
You can view documents by double-clicking them. You can also upload, delete, move, and perform other tasks on the documents, libraries, and folders.
When you create a team project, the process template that you use determines the default names and content of the folders that are located under the Documents node of Team Explorer. For a description of the documents that are provided with the Microsoft Solutions Framework (MSF) process templates, see Agile process template or CMMI process template. You can add other folders to the Documents node. The folders and subfolders always appear in alphabetical order.
You can use Team Explorer or your project portal to manage documents and document libraries. For information about how to manage documents in the project portal, see the help information that is provided for SharePoint Products.
Your team project has a project portal enabled and is associated with a SharePoint site. The Documents page appears in Team Explorer only when these conditions are met. See Configure or redirect process guidance.
You must be a member of the Team Foundation Valid Users security group. If the necessary security permissions are set explicitly, your View project-level information permission on the team project must be set to Allow.
You must also have Contribute permissions set for the project portal in SharePoint Products.
For more information, see Add users to team projects.
Upload a document
To upload a document in Team Explorer
In Team Explorer, under the Documents node, right-click the folder where you want to upload the document, and then click Upload Document.
In the Open dialog box, click the document that you want to upload.
If necessary, use the navigation buttons to locate the document.
The document is uploaded to the folder that you right-clicked.
To upload a document in Windows Explorer
In Team Explorer, expand the Documents node or child node where you want to upload the document.
In Windows Explorer, click the document that you want to upload, and then drag it to the folder or document library under the Documents node. Note that in Windows 8, Windows Explorer is File Explorer.
Create a document library
To create a document library in Team Explorer
In Team Explorer, right-click the Documents node for the team project where you want to create the document library, and then click New Document Library.
Type a name for the library, and then press ENTER.
Add a folder or subfolder
To add a folder or subfolder in Team Explorer
- In Team Explorer, right-click the folder that is above where you want to add the folder, and then click New Folder.
You can create folders only at the document library or folder levels. You cannot create a folder at the Documents node level.
- Type a name for the new folder, and then press ENTER.
Move, copy, or delete a document or folder
To move or copy a document or folder to a new folder
In Team Explorer, right-click the document or folder, and then click Cut or Copy.
Right-click the target folder, and then click Paste.
If you create a list of work items as a document in one team project and then move or copy that list to another team project, the bindings and references in that list continue to the first team project. For example, if a list of work items is contained in a Microsoft Excel (.xls) or Microsoft Project (.mpp) file, these files continue to be bound to the team project where the work items are defined. If you move the files to another team project, you do not change the server bindings. For information about how to change the server to which a document is bound, see Connect Excel or Project to a team project.
To delete a document or folder
In Team Explorer, right-click the document or folder, and then click Delete.
Rename a document or folder
To rename a document or folder
Right-click the document or folder, and then click Rename.
You cannot rename a folder if it represents a document library.
Type a new name, and then press ENTER.
You cannot change the file name extension for a document by using Team Explorer or the project portal.