Search your CRM

When you're on a CRM index page, you can search for specific records. This is located above the displayed view of your object index pages. The CRM search only works with certain default properties and reacts differently based on the search terms you use.

This article applies to the search bar on CRM index pages and doesn't apply to the global search in the top left corner of your HubSpot account. Learn more about the global search and custom searchable properties within global search.

Properties searched

The CRM search scans only the following property values in the object index pages to provide search results. Other properties that contain the searched string won't be surfaced. 

To search for records using properties other than those listed below, use filters, saved views, or segments instead.

Contacts

• First Name
• Last Name
• Primary Email
• Secondary Email (Case sensitive)
• Phone Number
• Company Name

Company

• Name
• Phone Number
• Website URL
• Company domain name

Deal

• Deal Name
• Pipeline (Enumeration property)
• Deal Stage (Enumeration property)
• Deal Type (Enumeration property)
• Deal Description

Ticket

• Ticket name
• Record ID
• Ticket status (Enumeration property)
• Ticket description
• Category (Enumeration property)

Custom objects

• Primary display property
• Secondary display properties

Please note: you can search with the primary or secondary display properties only when you haven't defined any searchable properties for the custom object.

Learn more about setting up custom objects.

Understand your CRM search terms and search results

The search terms you use in the CRM search may not bring you the search results you expected. In such cases, you may want to use a saved view instead. Below learn more about the expected CRM search behavior.

Search using enumeration properties

Enumeration properties contain pre-determined options which are set for a record via checkboxes, a dropdown menu, or radio select buttons. To search by enumeration properties, you must ensure your search terms must:

• Match the exact case of the option's internal value

• Be contained in double quotes (e.g., "value")

• Use the internal value for the option (e.g., Search for deals in the Appointment scheduled deal stage, your search should be the internal value "appointmentscheduled".)

To find the internal values of enumeration property options:

1. In your HubSpot account, click the settings settings icon in the top navigation bar.
2. In the left sidebar, click Properties.
3. Click the Select an object dropdown menu and select an object (e.g., Deal properties).
4. In the Search properties text field, search for the name of your desired enumeration property.
5. Click the name of the property.
6. In the property editor window, in the left sidebar, click Field type.
7. In the table, review the Internal Name column.

If you don't know a property's internal values, you can set filters for the property instead, which will populate records based on the criteria you set (e.g., filter by Deal stage, then select is any of Appointment scheduled).

Search using special characters

If you include a special character in your search (e.g., commas, hyphens, underscores, and dashes), HubSpot is likely to treat this as a delimiter and search the terms separate. For example, searching hedge-fund will be the same as searching hedge and fund as two separate terms in the same query.

The CRM search also does not support certain characters, such as the UTF-8 non-breaking space.

Search using non-alphanumeric language characters

If you're searching in a language with non-latin characters, some characters may result in different search results. 

For Japanese characters, the following behavior is expected:

• Each Kanji and Hiragana character is treated as an individual search term, so you'll receive search results with values containing the characters in any order (e.g., やまだ will search for や,ま, and だ in any order). To search for a specific sequence of characters, it is recommended to set a contains exactly filter instead, and include the value in double quotes (e.g., "やまだ").
• For Katakana characters, an unbroken sequence of characters is considered one search term. To search parts of the text separately, include a non-Katakana character as a delimiter, such as a space, Hiragana character, or number. To search for partial matches (e.g., include 山田シンタロウ in the search results when searching タロウ), add a * wildcard before the search term (e.g., *タロウ).

Search using "OR"

The capitalized phrase OR can be used as an 'or' operator in a search term.

For example, to search for contacts with the email domain website.com or the email domain landing.com:

• Your search term should be website.com OR landing.com.
• The search term website.com or landing.com will not work because the operator OR must be capitalized.

Search for text inside a longer string

The CRM search matches complete words only and doesn't support substring matching within a word. For example, to CRM search for a contact with the email myemail@website.com:

• Searching myemail will display the contact.
• Searching website.com will display the contact.
• Searching email will not display the contact.
• Searching site.com will not display the contact.

Search using repeated words or characters

If the same term is included twice or more in your search term, the CRM search will only search for one instance of it.

For example, to search for contacts with a company name Dance Dance Dance:

• When your search term is Dance Dance Dance, the CRM search will search for the term Dance, and not specifically Dance Dance Dance.
• Your results will include contact records whose company names are Dance Revolution and Real Dance.

Search using long numbers

When searching numbers, only the first 10 digits in the string are used.

For example, to search a contact with the phone number 1111111111234:

• When you search 1111111111234, the CRM search will uses the first ten digits only, being 1111111111.
• Your results will include contacts with the phone numbers 1111111111555 and 1111111111888.