Get started with Lists in Microsoft Teams

This is a preview or early release feature.

If your team has info to track, work to organize, or workflows to manage, the Lists app can help. Create a list of company assets to keep track of, for example, or incidents in a work area, or patients in a hospital wing. Customize the list to match how you work and share it so the whole team can keep informed and contribute.

If you've worked with Lists in SharePoint, Lists in Teams will be familiar. If not, we have step-by-step instructions. In either case, this article will get you started with Lists in Teams.

In this article

Introduction

Add a new list to a Teams channel

Add a list from another channel in the same team

Add a list from a different team

Add a SharePoint list to a Teams channel

Introduction

Team members create lists—from scratch, from a handy template, from an existing list, or from an Excel workbook—in the desktop or web version of Teams. On mobile devices, team members can view and edit lists, but not create or add them.

Note: Guests cannot create lists.

Lists appear as tabs along the top of channel pages.

Add a new list to a Teams channel

  1. Go to the channel of your choosing and click Add a tab  Add button  at the top of the page.

    Add a list icon at top of page

  2. In the Add a tab dialog box, select Lists (Beta) (you may have to use Search to locate it), and then select Save.

    Add a tab dialog box

  3. Select Create a list on the Teams page.

    Here you'll see your options for list creation.

    The Create a list page

To create a list from scratch

  1. Select Blank list, and then select Save.

  2. Enter a list name. If you'd like, also enter a description and choose a color and icon.

  3. Select Create.

To create a list from a template

Templates offer pre-formatted lists for common info-tracking situations. 

  1. Under Templates, select a template to view.
    Determine if it generally matches your needs. You will, of course, be able to make changes to the template you choose.

  2. If the template looks good, select Use template at the bottom of the page.

  3. On the next page, enter a list name. If you'd like, also enter a description and choose a color and icon.

  4. Select Create.

To create a list based on an existing list

Use the column headings, views, and formatting from another Teams list as the basis of your new list.

  1. Select From existing list.

  2. Select a team, select a list, and select Next.

  3. Enter a list name. If you'd like, also enter a description and choose a color and icon.

  4. Select Create.

To create a list from Excel

When you create a list from Excel, the worksheet headings become columns in the list, and the rest of the data becomes list items. For related information, see the SharePoint article Create a list based on a spreadsheet.

  1. Select From Excel.

  2. Locate and select the Excel file you want to use and then select Next.

  3. Follow the instructions on the Customize page.

Add a list from another channel in the same team

Get easier access to a list that's available within your team.

  1. Go to the channel of your choosing and select Add a tab  Add button  at the top of the page.

  2. In the Add a tab box that opens, select Lists (Beta) (you may have to use Search to locate it), and then select Save.

  3. Select Add an existing list.

  4. On the next page, under Select a list from the site, select the list you want to add. The selection includes all the lists in that team that you have access to.

Add a list from a different team

Get easier access to a list that's available on a different team that you're a member of.

  1. In Teams, go to the team site containing the list you want to add and open the list.

  2. At the top left of the list, select three horizontal dots  and then select Open in SharePoint.

    3 dots and Open in SharePoint option

  3. Copy the URL of the SharePoint page.

  4. Go to the channel that you want to add the list to and select Add a tab  Add button  at the top of the page.

  5. In the Add a tab box that opens, select Lists (Beta) (you may have to use Search to locate it), and then select Save.

  6. Select Add an existing list.

  7. On the Add an existing list page, paste the SharePoint URL under Paste a link to a SharePoint list to pin.

Important: Adding an existing list from a different team doesn't automatically give your team members access to the list. For more information, see Lists in SharePoint in the admin article.

Add a SharePoint list to a Teams channel

Your team will be able to view and comment on the SharePoint list, but not edit it. 

  1. In SharePoint, locate the list you want to add and copy its URL.

  2. In Teams go to the channel of your choosing and select Add a tab  Add button  at the top of the page.

  3. In the Add a tab dialog box, select SharePoint Lists (you may have to use Search to locate it), and then select Add a list from any SharePoint site.

  4. Under Paste a link to a SharePoint list, paste the URL you copied in step 1 and select Save.

Want to know more?

Read more about Lists

What is a list in SharePoint?

Data and lists in SharePoint (Create and edit)

Note: In the SharePoint articles, not all of the content applies to Teams.

For IT admins

Manage the Lists app for your organization in Microsoft Teams

Expand your Office skills
Explore training
Get new features first
Join Office Insiders

Was this information helpful?

Thank you for your feedback!

Thank you for your feedback! It sounds like it might be helpful to connect you to one of our Office support agents.

×