Microsoft Teams: Use an Existing SharePoint Library


Have you had a need to connect an existing SharePoint file repository to a team in Microsoft Teams? Perhaps you have a legacy SharePoint document library that has been in use for years, and stores many files valuable to the organization. I'd like to explore with you how to connect that existing document library to a channel in a team, so you can continue to use that investment without having to migrate data to the document library in Teams.


UPDATE 6/17/18: This is now replaced with the new SharePoint/Folder tab icon. Look for the first icon in the list!

First, background on files in Teams:

When a new channel is created within an existing team, a document library is created within the Office 365 Group the team is associated with. This document library is "pinned" to the channel as a tab called Files. This allows you to interact with the files in the document library directly within Teams without having to leave the application. Here's a couple of examples of what this looks like:

If you are curious about the relationship between document libraries and teams/channels, here's a nice diagram that helps to describe that relationship:

What if I want to use an existing document library?

If you have an existing document library from another SharePoint team site, it's possible to connect that library to the channel in Microsoft Teams. To do this, within the channel click the + icon at the top of the channel to add a new tab to the channel:

On the Add a tab dialog box, click SharePoint:

Next, in the SharePoint dialog box, you will be presented with two options: Relevant sites and Use a SharePoint link. Click Use a SharePoint Link:

In the Library Url field, type the URL of the document library. For my demonstration I will use once entered click Go: and the site will appear. Then click Next.

On the Pick a document library dialog box, select the document library you wish to connect to. For my demonstration I will use Documents then click Next.

On the Name your tab, give your tab a name ( I will use Online Marketing Documents) then click Save. (Note, the Post to the channel about this tab is checked. I like to do this as it alerts other team members in the conversation feed that this tab was created.

The Online Marketing Documents tab has now been created, and my existing files from the document library is shown. I can now interact with those files, and based on my preference , click the Open in SharePoint button to launch the SharePoint team site where that existing library lives.

What if I don't want to add a new tab?

If you do not wish to create a new tab from within the Files tab click Add cloud storage and then select SharePoint and follow the same on-screen instructions. This will create a new folder in the files tab that links to the SharePoint document library. This might be useful to make Teams simple to adopt and reduce complexity for end-users.

Click Add cloud storage

Click SharePoint

Following the same wizard as above when I created a tab, I will enter the Url of my document library.

Select Documents then click Next

Click Add folder

The document library will be added as a folder, (note the SharePoint icon on the folder).

Conclusion: This is a very easy way to bring existing SharePoint functionality such as a document library into Microsoft Teams so that your users can collaborate effectively in the team hub.