About SharePoint integration

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

SharePoint products are a valuable resource to users of Visual Studio Team Services (VSTS) and Team Foundation Server (TFS). With a SharePoint site, teams can easily store and share Office documents. SharePoint sites can be configured to show all kinds of information. We expect and encourage VSTS and TFS teams to use SharePoint and will continue to look for ways to make the integration of VSTS and TFS and SharePoint Server and SharePoint online, be better together.

TFS 2017 and earlier versions

Since its inception in 2005, TFS has integrated with SharePoint. That integration included SharePoint site templates and automatic site provisioning as well as support for browsing document libraries from inside Visual Studio Team Explorer. This integration works for SharePoint Server 2010 and 2013. It does not integrate with SharePoint Online nor support integration with VSTS.

With TFS 2013, TFS-SharePoint integration required you to install the TFS Extension for SharePoint on the SharePoint server and configure both servers to recognize each other. This integration provided the following features:

  • Automatically create a SharePoint site when creating a team project
  • Provision dashboard pages on that SharePoint site
  • Install SharePoint web parts that display TFS information such as work item query results and latest build results.
  • Support for browsing your SharePoint document libraries directly from Visual Studio Team Explorer.

However, you should consider the following before moving forward with this integration:

  • You can create your SharePoint site using SharePoint itself. Microsoft Teams also creates a team SharePoint site for sharing information
  • TFS 2017 Update 2 and later versions support Dashboards. Dashboards provide a very practical replacement for the TFS-SharePoint dashboards.
  • TFS dashboards offer an extensive catalog of widgets which replace all of the SharePoint web parts offered by this integration. Additionally, you can find widgets developed by our partners from the VSTS Marketplace.
  • Starting with TFS 2018, we are deprecating the tightly-coupled TFS-SharePoint integration in favor of integration using public APIs and extensibility frameworks.

You may want to ask yourself whether the integration benefits outweigh the costs of configuration.

If you are running TFS 2017 or earlier and want to configure your integration with SharePoint 2010 or 2013, read Configure SharePoint Integration - TFS 2017 and Earlier

If you are running TFS 2017, configured to integrate with SharePoint 2013, and want to upgrade to SharePoint 2016, you will need to disable SharePoint integration during the SharePoint upgrade, or your upgrade will fail. For more information, read Upgrade from SharePoint 2013 with TFS integration to SharePoint 2016.

TFS 2018 and later versions

Starting with TFS 2018, we will no longer offer the TFS Extension for SharePoint. Additionally, we won't support TFS 2017 integration with SharePoint 2016 (the TFS Extension for SharePoint only supports Sharepoint 2013 and earlier versions). TFS 2017 and earlier versions will continue to work with their supported versions of SharePoint. For more information, read Discontinue TFS 2017 (and earlier versions) SharePoint integration.

If you are upgrading to TFS 2018 from a previous version configured to integrate with SharePoint 2010 or 2013, you will need to disable the SharePoint integration after upgrade, or your TFS SharePoint sites will fail to load. For more information, read Disable SharePoint integration after TFS 2018 upgrade.

Future plans for TFS and VSTS SharePoint integration

Currently, our TFS and VSTS dashboards will meet most of your reporting requirements, replacing the previous dependency on TFS-SharePoint dashboards.

In the future, we plan to provide a way to embed a TFS or VSTS dashboard on a SharePoint site. From SharePoint, you will simply select a TFS or VSTS Dashboard to display, and it will be embedded on the SharePoint site. This will occur without laborious configurations. It will just work. It will also support both TFS and VSTS and SharePoint Server and SharePoint online.

If you need more than the built-in dashboards can offer, Power BI reports and Excel charts can be embedded on a SharePoint site. This functionality is available today.

We will update this topic as we provide additional SharePoint integrations.

Referenced topics