Skip to content
Lists

Determine your list criteria

Last updated: July 15, 2021

Applies to:

All products and plans

Use lists to organize your contacts and companies by their common traits. Once you understand the filtering options, you can set criteria to build lists that help achieve your business goals. You can add up to 250 filters to a list.

Depending on the type of list and your HubSpot subscription, you can choose from the following filter types:

Contact-based lists Company-based lists

Choose and combine list criteria

Before selecting criteria, learn how to choose filter options and use multiple sets of criteria to segment your records. Using these filters properly will help to pull in the correct records for your goal.

Select filter options and criteria

Once you select a filter type (e.g. Contact properties, Form submissions), you can segment by a property value (e.g. Lifecycle stage property) or an activity (e.g. submissions to a specific form). You can then choose filter options to specify the relationship between this value or activity and the records on your list. Learn how to select options and criteria depending on the field type.

Use AND and OR logic

List criteria can also be combined to filter records in a more specific way.

  • To identify objects that meet all criteria within a set of list filters, use AND logic.

  • To identify objects that meet at least one criteria within a set of list filters, use OR logic.

For example, you may want to send a marketing email to new leads, or to any contacts that filled out a form on your website. To gather those contacts, you can create a list of contacts who became a lead in a certain time and has their email address is known, or contacts that converted through a form submission.

and-or-logic-list-filters

Learn more about other ways to use AND and OR logic within HubSpot.

List filter types and criteria

Object, activity, line item, or quote properties

You can set criteria for your lists based on contact, company, deal, activity, or line item properties. Company lists can also be segmented based on ticket properties or properties of associated quotes.

Examples of possible criteria include:

  • contacts with the value Subscriber in the Lifecycle stage contact property.
  • companies with an associated deal where the Amount deal property is greater than $5,000.
  • contacts who have at least one call logged on their contact record.

To set your criteria, select a property, then depending on your property's field type, choose an option to set criteria based on that property:

Please note: the options that appear will depend on the property’s field type. For example, Date picker properties will have is before as an option, whereas Dropdown select properties will not. Different property field types will also require different actions for filtering. For example, the Lifecycle stage property is a dropdown select property, so to filter by Lifecycle stage, use dropdown menus to select the criteria.

  • contains all of: select multiple values. A record’s property must contain all of these values to be included in the list.
  • contains any of: for Text properties, enter your text. A record’s property must contain any of the entered text to be included in the list.
  • doesn’t contain all of: select multiple values. A record’s property must have none of these values to be included in the list.
  • doesn’t contain any of: for Text properties, enter your text. A record’s property must not contain any of the entered text to be included in the list.
  • ends with any of: for Text properties, enter your text. A record’s property must match the entered text at the end of the property value to be included in the list.
  • has (n)ever contained exactly: for Text properties, enter your text. A record's property must have historically (never) contained the exact entered text to be included in the list.
  • has (n)ever been any of: select multiple values. A record’s property must (not) have historically had any of these values to be included in the list.
  • has (n)ever been equal to: select a value. A record’s property must (not) have historically had the exact value to be included in the list.
  • has (n)ever been equal to any of: for Text properties, enter your text. A record’s property must (not) have historically been equal to the exact entered text to be included in the list.
  • has (n)ever contained any of: for Text properties, enter your text. A record’s property must (not) have historically contained any of the entered text to be included in the list.
  • is after: for Date picker properties, select a date on the calendar. A record’s property must have a date value that is after the selected date to be included in the list.
  • is after property: for Date picker properties, select another Date picker property. A record’s property must have a date value that is after their date value in the second property to be included in the list.
  • is any of: select multiple values. A record’s property must have at least one of these values to be included in the list.
  • is before: for Date picker properties, select a date on the calendar. A record’s property must have a date value that is before the selected date to be included in the list.
  • is before property: for Date picker properties, select another Date picker property. A record’s property must have a date value that is before the date value in the second property to be included in the list.
  • is between: for Date picker properties, select two dates on the calendar. A record’s property must have a date value that is equal to or after the first selected date and equal to or before the second selected date to be included in the list.
  • is (not) equal to: enter or select a value. A record’s property must (not) be equal to this value to be included in the list. For Numerical properties, an entered value of 0 is equal to a property value of 0, as well as to an empty property value.
  • is (not) equal to all of: enter or select multiple values. A record’s property values must (not) be equal to all of these values to be included in the list.
  • is (not) equal to any of: for Text properties, enter your text. A record’s property must (not) be equal to any of the entered text to be included in the list.
  • is greater than: for Numerical properties, enter a number. A record’s property must have a value that is greater than the entered number value to be included in the list.
  • is greater than or equal to: for Numerical properties, enter a number. A record’s property must have a value that is greater than or equal to the entered number value to be included in the list.
  • is known: all records with a value for the property will be included in the list. For Numerical properties, 0 is a known value, so records with a value of 0 will be included in the list with this filter is selected.
  • is less than: for Numerical properties, enter a number. A record’s property must have a value that is less than the entered number value to be included in the list. An empty property value is included as less than 0.
  • is less than or equal to: for Numerical properties, enter a number. A record’s property must have a value that is less than or equal to the entered number value to be included in the list. An empty property value is included as less than or equal to 0.
  • is more than: for Date picker properties, enter a number, select a unit of time, then select ago or from now (e.g. 5 days ago, 10 weeks from now). A record’s property must have a date value that matches the defined time frame to be included in the list.
  • is not between: for Date picker properties, select two dates on the calendar. A record’s property must have a value before the first selected date or after the second selected date to be included in the list.
  • is unknown: all records that do not have a value for the property will be included in the list. For Numerical properties, 0 is a known value, so records with a value of 0 will not be included in the list with this filter selected.
  • starts with any of: for Text properties, enter your text. A record’s property must match the entered text at the beginning of the property value to be included in the list.
  • (not) updated in last: enter a number of days. A record's property must (not) have been updated within the last number of days you enter. If you choose to filter records that have not been updated in that time, you can select the checkbox to include records with empty values as not being updated.
  • was updated after property: select another propertyA record’s property must have been updated after the last update of the second property to be included in the list.
  • was updated before property: select another propertyA record’s property must have been updated before the last update of the second property to be included in the list.

List memberships

You can filter records based on their list memberships. This filter can help you to combine different lists.

To set your criteria:

  • Select a list, then select an option:
    • is member of list: any record included in the selected list will be added to the new list.
    • is not member of list: any record not included in the selected list will be added to the new list.
  • Click Apply filter.

Form submissions

You can filter contacts based on their submissions to a HubSpot form.

To set your criteria:

  1. Select the form.
  2. In the dropdown menu, select to filter by if the Contact has filled out form or if the Contact hasn’t filled out form. You can select a specific HubSpot page that the form is on. This will filter out all contacts who did or did not submit to the specific form on that specific page. Otherwise, select Any page if there is no specific page.
  3. To refine the submissions further, click to expand Refine by date or Refine by number of times, then select an option.

Please note: if you've selected a non-HubSpot form, you cannot further refine the result by a specific page and should select Any page. The dropdown menus only include HubSpot pages and will not include any external pages that have your non-HubSpot form.

Once you're done, click Apply filter.

Imports

You can filter records based on the import they were part of.

To set your criteria:

  • Select an import, then select an option:
    • is in import: all records included in the import will be included in the list.
    • is not in import: all records not included in the import will be included in the list.
  • Click Apply filter.

Ads interactions

If you're using the HubSpot ads tool and you've connected one of your ad accounts, you can filter contacts by the corresponding Google Ad, Facebook Ad, and LinkedIn Ad properties. Learn more about how to segment contacts based on ad interactions.

Marketing emails

You can filter contacts by their marketing email activity, and refine this by date.

To set your criteria:

  1. Select a marketing email.
  2. Select the activity to filter the contacts by.
  3. To refine further, click to expand Refine by date, then select an option.

Once you're done, click Apply filter.

Email subscriptions

You can filter contacts based on the status of their email subscriptions. You can view email subscriptions in the left panel of a contact record.

To set criteria:

  • Select an option:
    • Contact has opted into all of: contacts who have opted into all of the select subscriptions will be included in the list.
    • Contact has opted out of all of: contacts who have opted out of all the selected subscriptions will be included on the list.
    • Contact has not opted into all of: contacts who have neither opted in or opted out of the selected subscriptions will be included in the list.
  • Click the dropdown menu, then select the checkboxes of the subscriptions you're filtering by.
  • To refine further, click to expand Refine by date, then select an option.
  • Once you're done, click Apply filter.

Page views (Marketing Hub or CMS Hub Professional and Enterprise only)

You can filter contacts by pages they've viewed on your website and refine this by date or number of visits.

To set your criteria:

  • Select an option:
    • Contact has (not) visited exact URL: contacts who have a page view in their contact record timeline that matches/doesn't match the exact URL specified. A wildcard (*) will not work.
    • Contact has (not) visited URL containing: contacts who have a page view in their contact record timeline that contains a specified part of a URL. For example, entering /marketing will show contacts who have visited a page on your website that contains /marketing in the page URL, such as http://www.domain.com/marketing/trade-shows or http://www.domain.com/contact/marketing-company. A wildcard (*) will not work.
    • Contact has (not) visited URL that matches regular expression: this is an advanced functionality, also known as regex, that HubSpot Support does not support. To learn more about building and testing regular expressions, visit RegExr. If HubSpot takes more than one second to test a contact against a condition using a regex filter, it will automatically return a value of false, and the contact will not pass the evaluation for that filter. A wildcard (*) will work.
Please note:
  • Visits to file manager file URLs are not tracked. If you enter a file URL in your page view filter, no contacts will meet your list criteria.
  • HubSpot strips UTM parameters from visited URLs on contact records. Learn more about how query string parameters are handled in lists and workflows.
  • HubSpot strips anchor links (i.e., any text after and including the # symbol) from visited URLs on contact records. If you enter text in your page view filter with an anchor link or the # character, no contacts will meet your list criteria.
  • HubSpot strips the trailing slash from visited URLs on contact records. You must remove the trailing slash when entering your URL in the criteria (i.e., instead of www.domain.com/directory/, enter www.domain.com/directory, because the last slash will be stripped by HubSpot).
  • In the field, enter a URL.
  • To refine further, click to expand Refine by date or Refine by number of times, then select an option.
  • Once you're done, click Apply filter.

Calls-to-action (Marketing Hub or CMS Hub Professional and Enterprise only)

You can filter contacts by a call-to-action (CTA) status and refine this by date or number of times. For example, you can create a list of contacts who have seen any CTA more than twice.

To set your criteria:

  • Select a call-to-action.
  • Select an option:
    • Contact has(n't) seen this version of the call-to-action: contacts who have (not) seen the call-to-action will be included in this list.
    • Contact has(n't) clicked this version of the call-to-action: contacts who have (not) clicked the call-to-action.
  • In the dropdown menu, select Any version of this CTA (includes smart rules) or Default version.
  • To refine further, click to expand Refine by date or Refine by number of times, then select an option.
  • Once you're done, click Apply filter.

Workflows (Professional and Enterprise only)

You can filter contacts by workflow status. For example, you can create a list of contacts who are currently active in a specific workflow. 

To set your criteria:

  • Select a workflow.
  • Select an option:
    • Contact is(n't) currently active: contacts who are (not) currently enrolled in the workflow will be included on the list.
    • Contact has (never) completed: contacts who have historically (never) completed the workflow will be included on the list. 
    • Contact has (never) been enrolled: contacts who have historically (never) been enrolled in the workflow will be included on the list.
    • Contact has(n't) met the goal: contacts who have (not) met the goal of the workflow will be included in the list.
  • Once you're done, click Apply filter.

Please note: when using the Contact has met the goal filter, only the contacts who met the goal criteria and were sent a marketing email from the workflow will be in the list.

Product properties (Professional and Enterprise only)

Filter contacts based on the properties of the products in their associated deals. You can view associated deals or products in the right panel of a contact record, in the Deals section and the Products section respectively.

To set criteria:

  • Select a product property, then select an option.
  • Once you're done, click Apply filter.

Behavioral Events (Marketing Hub Enterprise only)

You can filter contacts by behavioral events they've completed, and refine this by date or number of times. For example, you can create a list of contacts who have completed a specific event more than twice.

To set your criteria:

  • Select an event.
  • Select either Contact has completed to filter by contacts who have completed the event, or Contact hasn't completed to filter by contacts who have not.
  • To refine further, click to expand Refine by date or Refine by number of times, then select an option.
  • Once you're done, click Apply filter.

List criteria available with integrations

GoToWebinar webinar status

If you've integrated GoToWebinar with HubSpot, you can filter contacts by their GoToWebinar webinar status. For example, you can create a list of contacts who have registered for any webinar, or have not attended a specific webinar.

SurveyMonkey response

If you've integrated SurveyMonkey with HubSpot, you can filter contacts by their SurveyMonkey survey response. For example, you can create a list of contacts that have responded to a specific survey, or even given specific answers to questions in the survey.