Use lists in Slack

Lists help you organize and collaborate on work happening in Slack, and you can use them to track projects, manage tasks, and more. Create a new list from scratch or choose a customizable template to get started, then add tasks and work with others directly on list items.

Tip: Lists are part of most templates, pre-configured bundles of tools you can use to quickly set up a channel for a specific purpose like managing a project. If you aren’t using templates, you can learn more about ways to use lists.

 

Components of a list

Before you get started, we recommend taking some time to familiarize yourself with the components of a list and how you can customize them to help you stay organized. Review the chart below for a description of each component.

Visual showing five components of a Slack list which are also written out in the table below the image

Component

Definition

1. Items

Items are tasks you’re working on or keeping track of in a list. Click on an item to add or view additional details, like fields or comments in the item’s thread.

2. Fields

Fields contain information you want displayed alongside items. They’re customizable, and the data you add to a field can be entered in a variety of formats, like text, a selection from a drop-down menu, checkboxes, and more.

3. Views

Save filtering, sorting, and layout preferences as a view. Saving a view allows anyone with access to a list to quickly switch between different visualizations of the data in the list.

4. Filters and layouts

Sort, filter, hide, and group items to narrow down a list to tasks that are most relevant to you. You can filter items by certain fields in a list, and apply different layout options: table layout (organizes items by rows and fields by columns) or board layout (items are grouped by field, and you can move items between columns).

5. Threads

Start a thread on any list item to organize discussions around specific tasks. Mention other people in a thread to let them know that a list item requires their attention.

 

Create a list

To create a list, you can either start from scratch or use a template.

Start from scratch

Desktop

Mobile

  1. From the   Home tab, hover over   More, then select   Lists.
    An image of a cursor over the More icon in the Slack desktop app.
  2. Click   New in the top-right corner, then select   List.
  1. Tap   More at the bottom of your screen.
  2. Tap   Lists, then tap the plus icon in the top right.
  3. Give your list a name, choose an emoji, and add a description if you’d like, then tap Done.
  4. Tap Done to create the list.

Tip: You can import a .CSV file into a list from Slack on desktop. Click   New, then select   Import a CSV. To export a list to a CSV file, open a list, click the   three dots icon, and select   Download CSV.


Use a template

On desktop, you can use a template to create a list and save time on setup and formatting.

  1. From the   Home tab, hover over   More, then select   Lists.
    An image of a cursor over the More icon in the Slack desktop app.
  2. Click   New in the top-right corner, then select   List.
  3. Choose a template from the column on the left, then click Use Template.


Customize fields

Add or edit fields to include specific details like due dates, assignees, priority, and more.

Desktop

Mobile

  1. Click a field in the top row of the list, then select   Edit field.
  2. If you'd like, change the name of the field, or select an option from the Field type drop-down menu to change the format of the data.
  3. Click Save.
  4. To add a field, click the   plus icon at the end of the top row.
  1. From a list, tap the   Filters icon. 
  2. Tap Manage Fields, then select a field to customize it.
  3. Edit the name, field type, or other details, then tap Done.  
  4. To add a field, tap   Add field


Add items

Items in a list are the individual tasks you need to complete or the deliverables you’d like to keep track of. Each row in a list is a separate item.

Desktop

Mobile

  1. Click Untitled item and enter a description.
  2. For each item, click the field cell to enter the relevant data. 
  3. To add more items, click   Add item at the bottom of the list.
  1. Tap an empty item and enter a description.
  2. Tap a field cell to enter relevant data. 
  3. To add more items, return to the list and tap   Add item.

Tip: To delete an item on desktop, right-click the item and select Delete item. On mobile, long press the item and tap Delete Item.


Add messages to a list

Add any Slack message to a list right from the conversation.

Desktop

Mobile

  1. Hover over the message you'd like to add to a list.
  2. Click the   three dots icon, then select   Add to list.
  3. Search for and select a list, then click Add. To add a message to a new list, click Create New List.
  4. A detailed view of the item will open. Click any field to add information, or click X to close.
  1. Long press the message you'd like to add to a list.
  2. Select Add to List.
  3. Select a list to add the message.
  4. A detailed view of the item will open, and you can tap any field to add information.

 

Modify list views

Whether you created a list or you’re viewing someone else’s, you can adjust how the information in a list appears. You can filter, sort, and group items by field, and choose if items are displayed in a table or a board layout.


Filter and sort

You can filter and sort a list to easily surface the items that are most relevant to you.

Desktop

Mobile

  1. From a list, click the   filters icon.
  2. Choose how you’d like to filter, sort, hide, and group the items in the list.
  1. From a list, tap the   filters icon.
  2. Choose how you’d like to filter, sort, hide, and group the items in the list, then tap Done.


Change list layout

Desktop

Mobile

  1. From a list, click the   filters icon.
  2. Under Layout, select   Board or   Table.
  1. From a list, tap the   filters icon.
  2. Tap   Board, then tap Group by and choose how items should be displayed in board view.
  3. To switch back to the table view, tap the   filters icon, then tap
      Table (and remove the Group by if you'd like).


Create and save views

You can save sorting and layout options as a view for anyone with access to the list to use. For example, you might want to create a view that organizes list items by assignee or priority.

Desktop

Mobile

  1. From the default   All items view of a list, click the   filters icon. Then, choose how you’d like to filter, sort, hide, or group the items in the list.
  2. Click Save as New View
  3. To switch between views, click   All items and select a view.
  1. From the All items view of a list, tap the   filters icon and choose how you’d like to filter, hide, or group the items in the list.
  2. Tap   Board to change the layout if you'd like.
  3. Tap Save to new view, then give the view a name and tap Save.
  4. To switch between views, tap   All items and select a view.

Note: You need edit access to save views in lists you didn't create.

 

Work with others

You can share lists anywhere in Slack, assign items to people, and add comments on items in a thread.

Share a list

By default, lists are only visible to people or channels you share them with directly. You can also set general access permissions to decide if people who find your lists when searching in Slack can view or edit them.

Desktop

Mobile

  1. From a list, click Share in the top-right corner.
  2. Type the name of people or channels, then click the Can edit drop-down menu to decide if they can view or edit the list and select Share. The list will be sent as a message to the people or channels you specified.
  3. To set general permissions, click   Only invited people can access. Then choose   Anyone in [organization] can view or   Anyone in [organization] can edit.

You can share lists with people or channels on mobile, but it’s not possible to set general access permissions.

  1. From a list, tap the list name. Then, tap Share in Slack.
  2. Type the name of people or channels, then choose whether they can edit or view the list.
  3. Add a message if you’d like, then tap Send. The list will be sent as a message to the people or channels you specified.

Tip: Add a list as a tab in any conversation to make important lists easy to find.


Add assignees

Add a   People field to your list to track who’s working on each item. When you add an assignee, they’ll receive a notification in   Activity when the item is updated.

Desktop

Mobile

  1. From a list, click the   plus icon at the end of the top row to create a new field. If your list already has a   People field, skip to step 4.
  2. Add a name for the field, then select   People from the Field type drop-down menu.
  3. Choose if you’d like to allow multiple selections and whether you’d like names to show in the list, then click Save.
  4. Click the   people field on an item, then search for and select someone.
  1. From a list, tap the   filters icon.
  2. Tap Manage fields, then tap   Add field. If your list already has a   People field, skip to step 5.
  3. Select   People and tap Done
  4. Add a name for the field. Choose if you’d like to allow multiple selections, whether you’d like names to show in the list, and whether people should be notified about updates to their items. Then, tap Done.
  5. Tap an item, then tap the  People field to add an assignee.


Add comments to items

Each item in a list has a dedicated message thread that stays with it no matter where the item is shared, perfect for task-related conversations. Open an item to add questions, comments, or updates in the item’s thread.

Desktop

Mobile

  1. Hover over an item, then click   Add comment or View comment to continue a thread.
  2. Type and send your message.
  1. Tap an item, then tap   Add a comment.
  2. Type and send your message.

Note: If you mention someone in an item’s thread, they’ll receive a notification in their   Activity feed if the list is shared with them.

 

View version history

You can access past versions of a list, or view details about changes made to individual items.

  1. From a list on desktop, click the   three dots icon
  2. Select View version history from the menu. 
  3. Click on a row to view the version of the list from that specific date and time. Any information that changed will be highlighted in yellow.
  4. To view an item's detailed history, hover over the item and select   Open. Then, click the   three dots icon and select   View history


Archive list items

On the Pro and Business+ plans, lists can have up to 1,000 items. On Enterprise Grid, lists can have up to 5,000 items. If a list reaches the limit, the oldest items will automatically be archived, but you can manually archive individual items or groups of items anytime.

Archive an item

  1. From Slack on desktop, open a list.
  2. Right-click on the item you’d like to archive.
  3. Select   Archive item from the menu.


Archive multiple items

To archive several items at once, you can archive an entire view:

  1. From your desktop, open a list.
  2. Open the Views drop-down menu at the top of the list.
  3. Next to a view, click the   three dots icon.
  4. Select   Archive items in view, then click Archive to confirm.

Tip: To view all archived items in a list, click the   three dots icon in the top-right corner and select View archived items.


Delete or restore lists

You can delete lists that you created, and restore them if you deleted them within the last 24 hours.

Delete a list

  1. From your desktop, open a list.
  2. Click the  three dots icon, then select Delete list.
  3. Click Delete list


Restore a deleted list

  1. From your desktop, hover over   More, then select   Lists.
    An image of a cursor over the More icon in the Slack desktop app.
  2. Click Deleted in the sidebar.
  3. Find the list you'd like to restore, then click the   restore list icon
  4. Click Restore list.
Who can use this feature?