> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.pivotal.app/llms.txt.
> For full documentation content, see https://docs.pivotal.app/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.pivotal.app/_mcp/server.

# Search customers

Press `⌘K` (or `Ctrl+K` on Windows and Linux) anywhere in the app to open Workbench search. The cursor lands in an empty input. Start typing and Pivotal queries `name`, `domain`, contact emails, and any custom field you've configured. Results appear under headed groups (Customers, Onboardings, Tasks, Contacts) so you can tell what kind of record you're about to open. Hit `Enter` on the first result or arrow down to pick another.

## How the matching works

By default, search does a case-insensitive substring match on every searchable field. Type `acme` and you'll get `Acme Co`, `acme.com`, and `jeff@acme.com`. Type `gro` and you'll catch every customer on the `Growth` plan plus anything with `gro` in the name.

Three operators sharpen that:

* **Quoted strings** match exactly. `"Acme Co"` won't match `Acme Corporation`. Use this when a short string is showing up everywhere.
* **`field:value`** filters on a custom field. `region:emea` returns customers whose `region` custom field has the value `emea`. The field name comes from your [custom field configuration](/product/customers/tags-and-metadata).
* **`-term`** excludes. `acme -churned` matches "acme" and drops anything with `churned` anywhere in the indexed fields. Combine with `field:value` for things like `plan:enterprise -region:emea`.

## Worked examples

| Query                  | What it finds                                                     |
| ---------------------- | ----------------------------------------------------------------- |
| `acme`                 | Anything containing "acme" in name, domain, emails, custom fields |
| `"Northwind"`          | Exact match on the string "Northwind"                             |
| `plan:Enterprise`      | All customers with `plan` set to `Enterprise`                     |
| `domain:.io`           | Customers on `.io` domains                                        |
| `region:emea owner:me` | EMEA customers you own                                            |
| `at_risk -archived`    | At-risk customers that aren't archived                            |

`owner:me` is a shortcut for your user. Use `owner:<full-name>` to filter by a teammate.

## What ⌘K does not search

Search hits the Customer record and its Contacts. It does not search the body of task descriptions, comments, or activity-feed entries. For those, use the dedicated [Workbench search](/product/workbench/search) page, which has a wider index and supports date-range filters.

## The gotcha: stale custom field values

The search index updates within a minute of most edits, but bulk edits that touch hundreds of records can take a few minutes to reflect. If you ran a bulk update and a `field:value` query is still showing old results, give it five minutes before assuming something's broken.

## Related

* [Tags and metadata](/product/customers/tags-and-metadata)
* [Filters and views](/product/workbench/filters-and-views)
* [Workbench search](/product/workbench/search)

Email **[help@pivotal.app](mailto:help@pivotal.app)** with a screenshot of where you got stuck and the customer or onboarding id from the URL.