Create lists

Learn how to create lists for your workflows and projects.

What is a list?

A list is where you add, organize, and track your records in Attio. You can create lists for all of your workflows and projects.

Once you have some records in your list, you can add attributes such as labels, stages, and other fields to organize your data. Visualize your network with different view types like kanban and table views, and use filters to sort and refine your list. Lists can be shared with your team, or kept private.

A typical table view in Attio, one of the ways to display your lists. Records are shown in a spreadsheet style, with each cell representing a different deal in a sales process

For a video walkthrough of lists, see Attio Academy.

Create a list

To create a new list, select the + beside Lists in the sidebar. Then choose whether you'd like to start with a template, or click Start from scratch to set up your list manually.

Use a template

When creating a new list you can choose from our templates, organized by popular use cases. When you choose to start with a template, your list will be pre-populated with some useful attributes and views to help you get started. From that starting point, you can edit and further customize your list at any time.

Attio's list template gallery is shown, with a sales template selected

Start from scratch

If you choose to start from scratch, first choose the object you want to use. You can only have one object in your new list. If you're choosing between companies and people, consider whether you will be primarily adding data points about people or their companies, and keep in mind you can only mass send emails to people. Also give your list a unique name.

Then select a view type to start with, either a table or a kanban view. Learn more about view types.

Duplicate lists

You can duplicate an existing list if you'd like to use the same views and attributes but with different records. To duplicate a list, open the list you'd like to duplicate, select the ⋮ icon in the top right corner, then select Duplicate list.

Create a view

Views allow you to see the same list data in different configurable ways. You can easily switch between views and apply filters to get the most out of your list data. Views you create will be visible to everyone who has access to the list. Learn more about list access.

To create a new view:

  • Open the views dropdown beneath your list name or on an All records page

  • Select + Create new at the bottom of the dropdown, or select the ⋮

    icon next to a view and choose Duplicate to make a copy of it

  • If you are creating a new view, select the type of view you would like to create and give your view a name

The cursor hovers over a dropdown showing the options when creating a new view: table, kanban, and dashboard view.There are two types of views, Table views and Kanban views:

Adding records to lists

A record in Attio contains information about a specific item or entity. A specific person or a specific company are the most common examples of records in Attio. In the image above, you can see a typical list populated with records. A record might represent a deal, opportunity, candidate, etc. Records are represented as a row in a table view, or a card in a kanban view. Learn more about views in Attio.

To add a record to a list, hit e within the list and search for the record, or click the + at the top of the first column. You can also hit cmd + k and add a record from the quick actions menu by clicking Add to list. If a record already exists in your workspace, you’ll see their name suggested as you begin to type. If the person or company doesn’t yet exist as a record in your workspace, you’ll be prompted to create one.

When you go to add a record to a list that is already in the list, you will see the option to select the record already in the list to edit the attribute values for the existing instance, or you can click + Add duplicate to add it to the list again. Clicking + Add duplicate here will not create a duplicate record; it is just adding the record to the list again.

You can also add records in bulk by selecting the checkboxes for the records on Objects pages or in other lists, then clicking Add to List at the bottom of the page. Records can also be added to lists in bulk by CSV import.

Keep in mind that each list can only hold one type of object (e.g. companies or people). You won't be able to add people to a companies list, or vice versa.

Note: You must have at least Read and write access or be an admin in order to add records.

Sharing lists

You can share your lists with your team and collaborate in real-time. Learn more about sharing and collaborating, and managing list access.

Frequently asked questions.

  • All records views under Records (such as views on the People and Companies pages) are good for seeing all contacts that fit certain criteria. Since All records pages hold records for a particuar object, as new records are automatically created for people and companies you or your team members email or have calendar events with, they will be included automatically. Some good examples of All records view use cases would be seeing things like all companies in a certain city, or people with large Twitter followings, or people you've emailed/had calendar events with in the last week. ⁠

    ⁠Lists are more intended to represent specific processes or projects. You will need to identify which records are relevant to your list and add them manually. Unlike All records views, which are visible to all members of a workspace, it's possible to restrict who can view a list. ⁠

    ⁠You can create multiple views within the same list, and all views will hold all records in the list, but you can use filters to show/hide different subsets of records on each view. You can create lists with our list templates to see how we've set up the list and different views within the list as examples. ⁠

    ⁠In addition, with lists you can create list attributes, which are data points that will only show in that list but nowhere else in Attio. This allows you to track data that is relevant to records or a process represented in that particular list, but may not be relevant to all records of that specific object across your workspace.

Couldn’t find something? Contact us at [email protected]