# Search across columns

Quick search looks for text across searchable columns without specifying a column. It is a useful starting point when users do not know whether a term is a product name or a region.

Canonical: https://grid.syidax.com/docs/features/quick-filter/

<a id="understand"></a>

## How it works and when to use it

Find navigates to matching cells; Quick filter hides nonmatching rows. Present them according to these distinct purposes.

In the code, grid is the Grid element prepared in the installation chapter. Check each example's data and settings, and implement the app functions and server endpoints for your project.

- [Installation and integration · Shared sample data](https://grid.syidax.com/docs/guides/getting-started.md)

<a id="example-1"></a>

## Example 1. Pass a global search term

Connect your app's search input to quickFilterText.

```javascript
grid.quickFilter = true;
grid.quickFilterText = 'Platform';
```

Verify the result: Only matching rows remain in the current data. To search data not yet loaded, pass the term in remote requests.

<a id="example-2"></a>

## Example 2. Multiple-word conditions

Compare searches requiring both words with searches allowing either word.

```javascript
grid.quickFilterMode = 'and';
grid.quickFilterText = 'Platform APAC';
// To show rows matching either word:
// grid.quickFilterMode = 'or';
```

Verify the result: Word combinations change the results. Explain the condition relationship in the search input's guidance.

<a id="example-3"></a>

## Example 3. Tune input frequency and clear search

Adjust the delay to avoid expensive calculations or server requests on every keystroke.

```javascript
grid.quickFilterDebounce = 200;
grid.quickFilterText = '';
```

Verify the result: An empty string clears the search term. If your app enables regular expressions, also test invalid and overly broad patterns.

<a id="pitfalls"></a>

## Combining features and troubleshooting

Do not assume search includes every property of the source object. Check column configuration, display rules, and access rules together.

Previous results may remain briefly between search changes and server responses. Distinguish loading from no results.

<a id="related-api"></a>

## APIs used by this feature

- [quickFilter](https://grid.syidax.com/docs/options/quickFilter.md) — Displays a global search input. Use quickFilterText for an initial term or an external input.
- [quickFilterText](https://grid.syidax.com/docs/options/quickFilterText.md) — The quick-filter search string. Assign a new string from an external app search input too.
- [quickFilterPlaceholder](https://grid.syidax.com/docs/options/quickFilterPlaceholder.md) — Guidance for the quick-filter input. Describe the searchable data scope clearly.
- [quickFilterMode](https://grid.syidax.com/docs/options/quickFilterMode.md) — Combines terms with and, requiring all matches, or or, requiring any match.
- [quickFilterRegex](https://grid.syidax.com/docs/options/quickFilterRegex.md) — Interprets quick-filter input as a regular expression rather than ordinary text.
- [quickFilterDebounce](https://grid.syidax.com/docs/options/quickFilterDebounce.md) — Delay before applying quick-filter input. Balances continuous typing throughput and responsiveness.
- [quickFilterChanged](https://grid.syidax.com/docs/events/quickFilterChanged.md) — Emitted when quick-filter conditions change. Synchronize external search input values if needed.

<a id="next"></a>

## Related reading

- [How rows, columns, and IDs relate](https://grid.syidax.com/docs/guides/concepts.md)
- [Connect results and events](https://grid.syidax.com/docs/guides/data-event-access.md)
- [Explore in Features](https://grid.syidax.com/grid/quick-filter) — The guide describes which interactions are available to try.