> ## Documentation Index
> Fetch the complete documentation index at: https://help.broadstripes.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search builder

> Use the search builder to create advanced, multi-criteria searches without writing search text by hand.

## Overview

The **search builder** is a visual tool that helps you construct complex searches by selecting fields, operators, and values from dropdown menus. Instead of typing search syntax directly, you build your search one rule at a time.

The search builder is especially useful when you want to filter by multiple criteria at once. For example, you might want to find:

* Workers at a particular employer who have been assessed as "1s"
* People who attended a recent event but haven't been contacted lately
* Members on a specific shift who haven't signed a card

## Open the search builder

Click the **Search Builder** button in the top navigation bar, next to the search icon.

<img src="https://mintcdn.com/broadstripes/frQHyo0JLvHzfO19/images/search/search-bar-with-builder-button.png?fit=max&auto=format&n=frQHyo0JLvHzfO19&q=85&s=c16f4b1203f6d95648ee4bfc5acc66cf" alt="The search bar showing the Search Builder button" width="1400" height="65" data-path="images/search/search-bar-with-builder-button.png" />

The search builder panel opens above the search results area.

## Build a search with rules

When the search builder opens, you see a single empty rule with the heading **Find contacts matching the following rules...**

<img src="https://mintcdn.com/broadstripes/frQHyo0JLvHzfO19/images/search/search-builder-empty.png?fit=max&auto=format&n=frQHyo0JLvHzfO19&q=85&s=7f9157bf4b74af59ef4c8b5334e6962d" alt="The search builder with a single empty rule" width="1365" height="280" data-path="images/search/search-builder-empty.png" />

Each rule has three parts:

1. **Field** — choose what to search by (e.g., Shift, Assessment, Employer, Name, events, custom fields)
2. **Operator** — choose how to match (e.g., "contains the word(s)," "matches the text," "equals," "has any value")
3. **Value** — enter or select the value to match against (some operators like "has any value" don't require a value)

### Available search fields

The field dropdown includes all searchable data in your project, organized by category:

* **Custom fields** — any custom fields configured for your project (e.g., Shift, Pay Rate)
* **Events and event steps** — events and their individual steps
* **Contact info** — address, email, phone number
* **Contact timeline** — timeline notes, dates, and authors
* **General** — name, assessment, contact type, notes, lists
* **Department structure** — employer, department, parent organization
* **Employment** — job title, work location, employee status, seniority date
* **Leadership** — leader assignments, turf, roles
* **Relationships** — related contacts, family members, grievants
* **Email and texting** — sent messages, delivery status, SMS history
* **Call center** — call outcomes, call pools, callers
* **External IDs** — IDs from external systems
* **Contact types** — your project's configured contact types
* **Shapes** — geographic shape group membership

### Add rules to narrow your search

Click **+ Add rule** to add another condition. When using multiple rules, choose whether contacts must match **AND** (all rules) or **OR** (any rule) using the toggle at the top of the builder.

<img src="https://mintcdn.com/broadstripes/frQHyo0JLvHzfO19/images/search/search-builder-example-rules.png?fit=max&auto=format&n=frQHyo0JLvHzfO19&q=85&s=d0a0460fc6a72b2955e943442c7633a1" alt="The search builder with two rules: Shift contains &#x22;Morning&#x22; and Assessment has any value" width="1365" height="300" data-path="images/search/search-builder-example-rules.png" />

In this example, the search finds contacts whose **Shift** field contains "Morning" **AND** who have any **Assessment** value.

### Add rule groups for complex logic

Click **Add group** to create a nested set of rules with its own AND/OR logic. Rule groups let you build searches like: "Find contacts at Employer X who are assessed as 1 **AND** (attended Committee Meeting **OR** signed a Card)."

<img src="https://mintcdn.com/broadstripes/frQHyo0JLvHzfO19/images/search/search-builder-with-rule-group.png?fit=max&auto=format&n=frQHyo0JLvHzfO19&q=85&s=fe5515bca1887ae9f7d4d544465bb389" alt="The search builder with two rules and a nested rule group" width="1365" height="440" data-path="images/search/search-builder-with-rule-group.png" />

Each group has its own **AND/OR** toggle and its own **+ Add rule**, **Add group**, and **Remove** buttons. You can nest groups to create complex search logic.

<Info>
  For a detailed guide on using multiple rules and rule groups, see [Search with multiple rules](/docs/search/search-with-multiple-rules) and [Add rule groups to your search](/docs/search/add-rule-groups-to-your-search).
</Info>

### Remove a rule

Click the **Remove** button next to any rule to delete it from the search.

## Sort options

Click **Sort options** to expand the sort section. You can select a saved sort to control the order of your search results.

## Execute your search

When your rules are ready, click **Search** to run the search. Click **cancel** to close the builder without searching.

After executing, Broadstripes displays your search results with colored filter badges showing your active search criteria.

<img src="https://mintcdn.com/broadstripes/D9u4mZdC3VA_i7k6/images/search/search-results-with-data.png?fit=max&auto=format&n=D9u4mZdC3VA_i7k6&q=85&s=502b52b888d716a393afe33cbcf8aff2" alt="Search results showing filter badges and contact data" width="1465" height="380" data-path="images/search/search-results-with-data.png" />

From the results page, you can:

* Click a filter badge's **×** to remove that criterion
* Click **Save this search** to save the search for later
* Reopen the search builder to modify your search

## Video: How to search with the search builder

<div className="video-container" style={{position: 'relative', paddingBottom: '56.25%', height: 0, marginBottom: '2rem'}}>
  <iframe src="https://player.vimeo.com/video/322305306?title=0&byline=0&portrait=0&badge=0&autopause=0&player_id=0&app_id=58479" title="Build custom searches with Search Builder" style={{position: 'absolute', top: '0', left: '0', width: '100%', height: '100%'}} frameBorder="0" allow="autoplay; fullscreen; picture-in-picture" allowFullScreen />
</div>

## Get help

Click the **search help** link in the bottom-right corner of the search builder to visit the knowledge base for help with building searches.

## What's next

Learn more about building custom searches:

* [Search with multiple rules](/docs/search/search-with-multiple-rules)
* [Add rule groups to your search](/docs/search/add-rule-groups-to-your-search)
* [Broadstripes search language](/docs/search/search-language-reference)
