Filtering Contacts: Filters, Exclusions and AI Filters
Find exactly the contacts you need on the Contacts page. Build filters on any contact field or custom field, exclude the contacts you don't want (such as anyone tagged Spam), or describe who you're looking for in plain English and let AI build the filters for you.
Results update as you go. When the list looks right, you can act on everyone in it with bulk actions.
Contents
- Where to find filters
- Add a filter
- Combine filters with Match All or Any
- Exclude contacts
- Find contacts with or without a value
- Filter by date
- Describe your contacts with AI
- Show, hide and clear filters
- Act on your filtered contacts
- Limits
- Messages you might see
- FAQ
Where to find filters
- In Heymarket, go to Contacts.
- The filter bar sits at the top of the contacts table:
- Filters shows or hides your filters. The number on it is how many filters are active.
- The AI box ("Describe who you're looking for…") builds filters from a description. See Describe your contacts with AI.
- Below them are your filters, Add filter and Clear all.
The bar opens with an empty Name contains filter, ready to type into. An empty filter doesn't filter anything.
Add a filter
- Click Add filter.
- Pick a field. Type in Search Field to find one quickly. Contact fields come first, then your custom fields.
- Pick a condition, for example contains, is, or is before.
- Enter or pick a value.
There's no Apply button. Results update a moment after you stop typing, and the count below the table changes to match.
To change a filter, click any part of it (field, condition or value). To remove one, click the × on it.
Fields you can filter on
| Field | Notes |
|---|---|
| Name, First Name, Last Name | |
| Phone Number | Type any part of the number. Dashes, spaces and brackets don't matter. |
| Email address tied to the comtact | |
| Date Added | When the contact was added to Heymarket. |
| Contact Owner | Shown only to users who can see all contacts. |
| SMS Status | Subscribed, Opted Out, Blocked. Shown if your team has a text inbox. |
| Email Status | Subscribed, Unsubscribed, Bounced. Shown if your team has an email inbox. |
| Contact Sentiment | Shown if your team has AI Sentiment Analysis. |
| Tag | Contact tags. |
| List Name | Lists the contact belongs to. |
| Custom fields | Every custom field on your team. |
Conditions by field type
| Field type | Conditions |
|---|---|
| Text (names, phone, email, text custom fields) | contains, does not contain, is, is not, starts with, is empty, is not empty |
| Number custom fields | is, is not, greater than, greater than or equal to, less than, less than or equal to, is between, is not between, is empty, is not empty |
| Date (Date Added, date custom fields) | is on, is not on, is before, is on or before, is after, is on or after, is between, is not between, in the last, in the next, more than … ago, is empty, is not empty |
| Tag | includes any of, includes all of, does not include, is empty, is not empty |
| List Name | is any of, is none of, is empty, is not empty |
| Contact Owner | is, is not, is any of, is none of, is empty, is not empty |
| Contact Sentiment | is, is not, is any of, is none of, is empty, is not empty |
| SMS Status, Email Status | is, is not, is any of, is none of |
Tip: Greater than and less than work only on Number and Date custom fields. If a field holds numbers but was created as Text, an admin can change its type in the Contacts settings in Admin.
Combine filters with Match All or Any
Once you have two or more filters, a Match switch appears at the start of the bar:
- All: a contact must match every filter. Filters are joined with and.
- Any: a contact needs to match at least one filter. Filters are joined with or.
Exclude contacts
Every field type has conditions that leave contacts out of your results:
| To leave out… | Use | Example |
|---|---|---|
| Contacts whose text includes a word | does not contain | Name does not contain "test" |
| Contacts with one exact value | is not | SMS Status is not Opted Out |
| Contacts with any of several values | is none of | Email Status is none of Unsubscribed, Bounced |
| Contacts with a tag | does not include | Tag does not include Spam |
| Contacts on a list | is none of | List Name is none of Newsletter |
| Contacts in a number or date range | is not between | Customer Age is not between 30 and 40 |
| Contacts on a specific date | is not on | Date Added is not on Oct 1, 2026 |
Combine exclusions with other filters to narrow your audience. The screenshot at the top of this article finds Gold customers who aren't tagged Spam:
- Tag includes any of Gold
- Tag does not include Spam
- Match: All
Contacts with no value are included
An exclusion keeps every contact that doesn't have the value, including contacts where the field is blank. For example, City does not contain "Austin" also returns contacts with no City at all, and Tag does not include Spam also returns contacts with no tags.
To leave out blank contacts too, add a second filter on the same field: City **is not empty**.
Find contacts with or without a value
Use is empty to find contacts missing information, such as everyone with no email address (Email is empty). Use is not empty to find only contacts that have it (Phone Number is not empty).
Fields every contact always has, such as Date Added and SMS Status, don't offer these two conditions.
Filter by date
Date fields can be filtered two ways:
- On a calendar date: is on, is before, is after, is between, and so on.
- Relative to today: in the last 30 days, in the next 2 weeks, or more than 6 months ago. Type a number and pick Days, Weeks, Months or Years. Relative dates move with the calendar, so "in the last 7 days" always means the last 7 days.
Dates use your computer's time zone.
Describe your contacts with AI
Type who you're looking for, and AI turns it into regular filters you can see and edit.
- Click the AI box at the top of the filter bar ("Describe who you're looking for…").
- Describe the contacts. For example: tagged Gold but not Spam, age 30 to 40.
- Press Enter or click Generate filter.
In a few seconds your description becomes filters in the bar, and the results update. Each filter works like one you added yourself, so you can change it, remove it or add more.
Example descriptions
| You type | Filters you get |
|---|---|
| tagged Gold but not Spam, age 30 to 40 | Tag includes any of Gold and Tag does not include Spam and Customer Age is between 30 and 40 |
| opted out of SMS or tagged Spam | SMS Status is Opted Out or Tag includes any of Spam |
| opted out of SMS or unsubscribed from email | SMS Status is Opted Out or Email Status is Unsubscribed |
| first name starts with J, last name contains son, phone contains 212 | First Name starts with "J" and Last Name contains "son" and Phone Number contains "212" |
Words like not, except and but not become exclusions. Or becomes Match Any.
Tips for better results
- Name the field. AI knows your field names, tags, lists and team members, but it can't see what's stored in your contacts. City contains Austin works better than Austin contacts.
- Use your own names. Use tag, list and custom field names the way they appear in Heymarket.
- Keep it to contact details. AI filters work on contact fields. They can't search message content, conversation history or campaign activity.
- Write in English. Other languages may not work.
When part of your description can't be used
AI applies what it can and tells you what it left out. For example, Gold customers who love pizza becomes Tag includes any of Gold, with the message Couldn't find a field for 'who love pizza'.
Other messages you might see:
- Couldn't find 'Platinum' in your tags, lists, team or field values
- 'Gold' could mean more than one field or value. Add it with Add filter.
- Filters can't express 'replied last week'
Add the missing piece yourself with Add filter, or rephrase and try again.
If nothing in the description can become a filter, you'll see We couldn't turn that into filters. Try rephrasing and naming a field, like "last name" or a custom field. Your existing filters stay as they were.
Generating replaces your current filters
If you've set up or changed filters yourself, Heymarket asks Replace your current filters? before it generates. Click Replace filters to continue, or Cancel to keep what you have.
To add to AI-generated filters instead of replacing them, use Add filter.
Good to know
- Your contact access still applies. If you can only see contacts you own, AI filters search only those contacts.
- Privacy: AI receives your description and the names of your fields, tags, lists and team members. It doesn't read your contacts' details or messages.
- AI usage: AI filters don't count toward your team's AI usage allowance.
- Length: descriptions can be up to 500 characters.
- To stop a request in progress, click the × in the AI box.
Show, hide and clear filters
- Hide filters: click Filters. The bar collapses to one line that shows each filter as a pill. Remove a pill with its ×, or click Edit to open the bar again. Heymarket remembers whether you left the bar open or closed.
- Clear all: removes every filter and shows all contacts again.
Act on your filtered contacts
Bulk actions work on your filtered results. Select contacts on the page, or choose Select all to act on every contact that matches your filters, not just the page you're looking at.
Note: When a List Name filter is active, Select all is unavailable. You can still select contacts page by page.
Messages you might see
| Message | What to do |
|---|---|
| Enter at least 3 characters | Contains needs 3 or more characters. Type more, or use starts with or is. |
| Finish this filter or remove it and Results and bulk actions are paused until the highlighted filter is finished or removed. | A filter is missing a value. Finish it or remove it, and results resume. |
| Field "…" no longer exists | That custom field was deleted. Remove the filter. |
| Greater/less than needs a Number or Date field. | The custom field is Text. An admin can change its type in the Contacts settings in Admin. |
| Contacts could not load for these filters. Try again. | Results didn't load. Try again in a moment. |
| We couldn't build filters from that. Try again, or use Add filter. | The AI request didn't finish. Try again, or build the filters yourself. |
| AI filters aren't available for your team. | Your plan doesn't include AI filters. Contact support. |
| Shorten your description to 500 characters or fewer. | Shorten the AI description. |