Create and use list properties

To filter your lists by property values and create saved views to revisit certain lists, you can create custom list properties. For example, create a List purpose property to indicate why the list was created and how it should be used, such as for a marketing email or for tracking event attendees.

Custom list property values can be set when you create a new list or from the lists index page after a list is processed.

Please note: list properties are for filtering lists, not the records within a list. If you want to set criteria for which records to include in a list, create and use properties for the object in the list (e.g., contacts, deals) rather than list properties.

Create list properties

To create custom list properties:

1. In your HubSpot account, click the settings settings icon in the top navigation bar.
2. In the left sidebar menu, navigate to Properties.
3. Click the Select an object dropdown menu, then select List properties.
4. Click Create property.
5. Set up your property, then click Create.

Learn more about creating and editing properties.

Add properties to the create list form

To add your list properties to the form shown when creating a new list:

1. In your HubSpot account, click the settings settings icon in the top navigation bar.
2. In the left sidebar menu, navigate to Objects > Lists.
3. Click Customize the 'Create list' form.
4. In the left sidebar of the list form editor, click Add properties.
5. Select the checkbox next to the custom property. 
   
   
6. You can also set up conditional logic, make properties required, or rearrange properties. Learn more about customizing the create form.
7.  Click Save in the upper right.

With the property added to the list create form, you can now access the property in the Custom properties section when creating a list.

Update list properties

You can update custom property values for existing lists from the lists index page:

1. In your HubSpot account, navigate to CRM > Lists.
2. Hover over a list, then click Details.
3. In the right panel, in the Custom properties section, update the property value.
4. Click Save.

Use list properties to filter lists

You can use custom properties when viewing and filtering your lists on the lists index page. Learn how to filter lists or create and manage list views.