Skip to content
Lists

Create and use lists

Last updated: July 15, 2021

Applies to:

All products and plans

The lists tool in HubSpot allows you to create a list of contacts or companies based on property values and other characteristics, including activities. This article includes instructions for creating and editing lists from the lists tool. To add records to existing lists, learn how to set up list criteria or manually add records to static lists.

Other HubSpot tools rely on lists to make changes to a specific group of contacts. Some uses of lists in HubSpot include:

The above uses are currently not available for company lists. However, you can still create a list to analyze the contacts or companies that fit a certain criteria.

Please note: the maximum number of lists you can create depends on your subscription. Learn more about subscription options and limitations in the Product & Services catalog.

Types of lists

There are two types of lists in your HubSpot account: active lists and static lists.

Active lists

Active lists automatically update their members based on its criteria. Records will join the list when they meet the criteria and leave the list when they no longer meet the criteria.

Examples of when active lists should be used include:

  • sending unique marketing emails based on each contact's behavior and properties. If you send out a regular newsletter, an active list automatically manages the continually changing list of subscribers.
  • placing outbound calls to contacts based on behavior and property values.
  • grouping your contacts by lifecycle stage to continually identify behavior and properties for contacts in each stage.
  • segmenting records based on properties that change frequently over time, such as HubSpot score.

Static lists

Static lists include records who meet a set criteria at the point when the list is saved. Static lists do not update automatically, so new records who meet the criteria will not be added to the list. Records can be manually added and removed from static lists.

Examples of when static lists should be used include:

  • manually adding records to a workflow.
  • sending one-time email blasts, email campaigns that you don't run often, and for a list of contacts that doesn't change (e.g., event attendees, staff lists for an internal newsletter, or lists from a trade show). 
  • manually grouping records that may not have a shared list criteria.
  • segmenting to bulk delete records from your account.

Create a list

  • In your HubSpot account, navigate to Contacts > Lists.
  • In the upper right, click Create list.
  • In the left panel, select Contact-based to create a list of contacts, or Company-based to create a list of companies.
  • In the right panel, enter a name for the list and select if you want an Active list or a Static list.
  • In the upper right, click Next.
  • In the left panel, set the criteria for the contacts or companies you want to segment. Learn the list criteria available to you and how they work. You can select up to 250 filters per list.
    • Select a filter type.
    • Scroll or type to search, then select the property or activity to filter by.
    • Select an option, then set your criteria based on the field type:
      • Dropdown select or checkbox: click the dropdown menu and select the checkboxes to the left of the values.
      • Text: click the Add options dropdown menu and type to enter a text value. If you’re adding multiple options, separate each value with a semicolon (e.g. Boston; Chicago; New York).
      • Numerical: click the field and type to enter a number value. If you’re adding multiple options, separate each value with a semicolon (e.g. 10; 25; 30). This applies to Number, Score, and Calculation properties. 
      • Date picker: click the date calendar field, then in the calendar, select a date.
select-filter-options-list
  • Once you've set your criteria, click Apply filter. Records that fit this criteria will populate in the table.

Please note: after applying a filter, the set of records that appear is a preview of records that will be added to your list. When the list is saved and fully processed, the exact count of records will be visible under the list's name in the upper left.


  • To test if an existing record meets the filters:
    • In a contacts list, click the Actions dropdown menu in the upper right and select Test a contact.
    • In a companies list, click Test filters in the left panel. Click the Search dropdown menu and select the record you want to test.
  • In the upper right, click Save. Your list may take some time to process.

Once the list has finished processing, you can continue editing your list.

View and edit a list

  • In your HubSpot account, navigate to Contacts > Lists.
  • By default, you will be on the Contact lists library tab. To locate a company list, click the Company lists library tab. To view contact lists that are not currently used by other HubSpot tools, click the Unused Contact lists tab.
  • In the table, click the list you want to view or edit.
  • To search for a specific record in your list, use the search bar in the upper right.
  • In the upper right, click the Actions dropdown menu to perform more actions with your list:
    • Edit columns: select the contact properties to display for each contact in the table.
    • Export/Export list: download a copy of the list.
    • Test a contact: check if a specific contact meets the list criteria. This only applies to contact lists.
    • Move to folder: select a list folder to move the list to.
    • Clone: clone the list.
    • Delete list: permanently delete the list. You can only delete lists that aren't actively being used elsewhere in HubSpot. Records in the list will not be deleted. Learn how to bulk delete records.
    • Create a report: build a custom report based on your contact lists.
    • View list performance: analyze your list's metrics, such as the list's size over time, and the breakdown, engagement, and activity of the list's contacts. This only applies to contact lists.
    • Resync list with Salesforce (Professional and Enterprise only): trigger a resync of the list with Salesforce if you're using the Salesforce integration for contacts.
    • Use this list to limit Salesforce Sync (Professional and Enterprise only): specify the list as an inclusion list for contacts that will sync to Salesforce, if you're using the Salesforce integration. Learn more about Salesforce inclusion lists for contacts.

  • In the table, you can sort the contacts based on their property values by clicking the headers.

Delete a list

If you have reached your account's list limit, you may want to delete a list without deleting its records. If you would like to delete the records in a list, learn how to delete the contacts and companies from a list.

  • In your HubSpot account, navigate to Contacts > Lists
  • To view only lists that haven't been used or updated in the last two months, click the Unused lists tab. You can also continue with your deletion in the Lists library tab.
  • To delete a single list, hover over a list and click the More dropdown menu, then select Delete list.
  • To bulk delete lists, select the checkboxes next to the lists you want to delete and click Delete at the top of the table.

  • In the dialog box, click Delete.

Learn more about why you may be unable to delete a list.