Lists

Determine your list criteria

Last updated: November 25, 2019

Applies to:

Marketing Hub  Starter, Professional, Enterprise
Legacy Marketing Hub Basic

Lists help you identify and organize your contacts by traits they have in common. By seeing all your options for list segmentation and understanding what your marketing goal is, you can determine which criteria makes sense for creating your list.

Navigate to the section on the specific list criterion you are looking for in the Table of Contents on the right. These list criteria can be combined in multiple ways to filter contacts on more granular levels.

Please note: list segmentation criteria in Marketing Hub Starter accounts is limited to form submission data, contact property information, and marketing email activity.

Contact, company, or deal properties

Filter your contacts by contact, company, or deal properties. Examples include creating a list of:

  • contacts with the value Subscriber in the contact property HubSpot Lifecycle Stage;
  • contacts with an associated company with the company property Industry known; and
  • contacts with an associated deal with the deal property Amount greater than $5,000.

After selecting a property, you'll see the specific options available for filtering. This differs based on the property's field type.

For example, the HubSpot Lifecycle Stage contact property is a radio select field type, so you can select existing or historical option values.

The deal property Amount is a number field type, so you can select arithmetic operations like is equal to, is less than or equal to, is greater than, as well as historical numeric values. Because number field types can be blank or a 0, different list criteria may include or exclude certain objects:

  • When selecting is unknown, the list will include objects with the property being empty. If the object's property contains 0, this is a known value and the object will not be included in the list.
  • When selecting is known, the list will exclude objects with the property being empty. If the object's property contains 0, this is a known value and the object will be included in the list.
  • When selecting is equal to and entering 0 in the field, the list will include contacts with an empty property and contacts whose property contains 0.
  • When selecting is less than or is less than or equal to, the list will include contacts with an empty property and contacts whose property contains 0.

Activity properties

Filter contacts by activities on their contact record. Activities include meetings, conversations, tasks, notes, one-to-one emails, and phone calls that have been logged in HubSpot and you can filter a contact based on the activity details. Learn more about using activity properties in a filter.

For example, you can create a list of contacts who have had a certain type of activity on their contact record.

Line item properties

Filter contacts by the properties of a line item in an associated deal.

For example, you can create a list of contacts with at least one associated deal that has at least a product with the Quantity of 1.

List memberships

Filter contacts by their list memberships. This filter can help you to combine different lists.

Form submissions

Filter contacts based on their submissions to a HubSpot form. After selecting the Form submissions filter:

  1. Select the specific form. This will filter out all contacts who has submissions to this specific form.
  2. After selecting the specific form, in the dropdown menu, select a specific page. This will filter out all contacts who submitted to the specific form on that specific page. Select Any page if there is no specific page.
  3. Refine the submissions by date and by the number of times a contact submitted to the form. This step is optional.

 

Marketing emails

Filter contacts by their marketing email activity, and refine this by date. After selecting the Marketing emails filter:

  1. Select the specific marketing email.
  2. After selecting the specific email, select the activity to filter the contacts by.
  3. Refine the submissions by date. This step is optional.

Email Subscriptions

Filter contacts based on the status of their email subscriptions.

Imports

Filter contacts based on the import they were part of when they were added to HubSpot.

Page views

Filter contacts by pages they've viewed on your website, and refine this by date or number of times. Page view options include:

  1. Contact has/has not visited exact URL: contacts who has a page view in their contact record timeline that matches the exact URL specified.
    • For example, entering http://www.domain.com/pricing/marketing will show contacts who have or have not visited the specific tracked page containing that exact URL. A wildcard (*) will not work.
  2. Contact has/has not visited URL containing: any contact who has 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-companyA wildcard (*) will not work.
  3. Contact has/has not visited URL that matches regular expression: also known as regex, this is an advanced functionality that HubSpot Support does not support, so it should only by implemented by users who are familiar with regular expressions. RegExr is a helpful website to learn, build, and test Regular Expressions. If it takes HubSpot's internal processes more than one second to test a contact against a condition using a regex filter, HubSpot will automatically return a value of false, and the contact will not pass the evaluation for that filter. A wildcard (*) will work in this option.

Please note:

Product properties

Filter contacts by the products in their associated deals.

Events

Filter contacts by 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 at least twice.

Please note: the event option is only available for Marketing Hub Enterprise accounts.

Workflows

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

Please note: the workflow status option is only available for Marketing Hub Professional and Enterprise accounts.

Call-to-Action

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 all variations of a specific CTA more than twice.

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.

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.

Combining multiple list criteria

List criteria can be combined in multiple ways to filter contacts on more granular levels, and AND and OR logic can be used with multiple criteria sets.

For example, you can create a list of contacts who became a sales qualified lead in a certain time and has their first name known, or contacts that converted through AdWords. This will result in a list that includes both contacts who became a sales qualified lead between the specified dates with their first names known and contacts who have converted through Adwords.

/lists/determine-your-list-criteria