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

# Search

> A specialized Input for finding and filtering content. The search icon and clear button are built in — don't add your own.

## Search

<Badge color="blue">v1.0.0</Badge> | [View in Storybook](https://master--695bb4b1b8041ae09768950a.chromatic.com/?path=/docs/primitives-search--docs)

### When to use

* A list, table, or dataset where the user needs to locate specific items quickly.
* Content-heavy pages where scrolling to find something isn't practical.
* Global search across the whole application (scoped to the [Command](/aura-design-system/primitives/command)).

### When not to use

* Choosing from a known set of options — use [Combobox](/aura-design-system/primitives/combobox) or [Select](/aura-design-system/primitives/select).
* Filtering by multiple attributes simultaneously — use filter controls alongside or instead.
* Free text input unrelated to finding content — use a plain [Input](/aura-design-system/primitives/input).

### Dos and don'ts

* Do scope the search clearly — make it obvious whether it's searching the current list, the current page, or the whole app.
* Do show a no-results state when the query returns nothing; don't leave an empty list with no explanation.
* Do debounce live search to avoid excessive requests while the user is still typing.
* Do use expected placeholder text that describes the scope: "Search assets" is more useful than "Search...".
* Do make sure search and filters work together — applying a filter shouldn't silently clear the search query.
* Don't trigger search only on form submit if live filtering is possible — users expect immediate feedback.

### Often used with

* The list, [Data grid](/aura-design-system/primitives/data-grid), or page being filtered; optional adjacent filters ([Select](/aura-design-system/primitives/select), [Combobox](/aura-design-system/primitives/combobox)); clear affordance; scope called out in placeholder or [Helper text](/aura-design-system/primitives/helper-text).