search

Storefront search: the query, live results, suggestions and featured products.

import { … } from '@poltura/theme-sdk/search';

Hooks

Name	What it is
`useSearch`	The shopper's search: what they typed, debounced product results, suggestions and featured products.

Name	What it is
`SearchInput`	The search field with its icon and clear button; inside `SearchCombobox` it is the combobox the arrow keys drive.
`SearchResults`	The products matching the query, with the searching and no-results notes.
`SearchSuggestions`	What search offers before the shopper types: popular searches as chips and the featured products.
`SearchDialog`	A search icon button that opens its content in a dialog near the top of the page.
`SearchCombobox`	The search field as a combobox: suggestions before typing, live results after, the arrow keys walking both and Enter opening the highlighted one.

Name	What it is
`HeaderSearch`	The complete header search: the field as a combobox, suggestions before typing and live results after.

Name	What it is
`SearchState`	The storefront search: the query, live results, suggestions and the actions that drive them.
`SearchSuggestion`	A suggestion shown before or while the shopper types: a popular or recent search, or a matching category, collection or page.
`SearchOptions`	Options of `useSearch`.
`SearchInputProps`	Props of `SearchInput`.
`SearchResultsProps`	Props of `SearchResults`.
`SearchSuggestionsProps`	Props of `SearchSuggestions`.
`SearchDialogProps`	Props of `SearchDialog`.
`SearchGroupKind`	A result group of the search dropdown, as the element type the merchant adds under a search block.
`SearchGroup`	One result group of the search dropdown, in the order the dropdown lists it.
`SearchDropdown`	How the search dropdown is drawn.
`SearchComboboxProps`	Props of `SearchCombobox`.
`HeaderSearchProps`	Props of `HeaderSearch`.

Last updated Oct 29, 2026