> For the complete documentation index, see [llms.txt](https://nextsky.gitbook.io/purity-theme/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nextsky.gitbook.io/purity-theme/theme-settings/search-behavior.md).

# Search behavior

**Search behavior settings** control how the search interface appears and how users interact with product search in your store.

<figure><img src="https://1059363070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRcDJSoM26kdEZlVFekVW%2Fuploads%2FEWbF4DApwxd2aIfjrIXY%2Fimage.png?alt=media&amp;token=6f8cd21e-85ad-434f-9eb1-f9940e25fb51" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="215">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Type</strong></td><td>Choose between a <strong>popup</strong> or <strong>drawer</strong> layout for the search interface.</td></tr><tr><td><strong>Show results</strong></td><td>Display search results in a <strong>Tab</strong> layout based on result type (e.g., products, collections), or use a <strong>Default</strong> text layout for a simpler, unified view.</td></tr><tr><td><strong>Show search history</strong></td><td>Show the recently used keywords for searching.</td></tr><tr><td><strong>Search placeholder</strong></td><td>Placeholder text in the search bar.</td></tr><tr><td><strong>Popular search</strong></td><td>Recommend keywords to guide users toward common or trending search terms (e.g., t-shirt, dress, black).</td></tr><tr><td><strong>Products recommendation</strong></td><td>Select a specific product to highlight or suggest within the search area.</td></tr><tr><td><strong>Enable predictive search</strong></td><td>Display live search suggestions as users type. <em>*Note: not available in all languages.</em></td></tr><tr><td><strong>Show product price</strong></td><td>Display product prices directly in the search dropdown or result list.</td></tr></tbody></table>

### Speech search <a href="#speech-search" id="speech-search"></a>

Speech search adds a microphone button to the search field, so shoppers can say their search instead of typing it.

<figure><img src="https://1059363070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRcDJSoM26kdEZlVFekVW%2Fuploads%2FhZ7eilVDNpbnGsFvBJlQ%2Fimage.png?alt=media&amp;token=e672f639-dbb5-4405-824d-b776360c359f" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="215">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Enable speech search</strong></td><td>Show the microphone button in the search field. Find it in Theme settings -> Search. Default: off.</td></tr></tbody></table>

The button appears in two places:

* The search popup or drawer in the header.
* The search field of the main search section.

Browsers that do not support speech recognition do not show the button.

#### How it works <a href="#how-it-works" id="how-it-works"></a>

1. The shopper selects the microphone button. The browser asks for microphone permission the first time.
2. The button changes while the browser listens. Select it again to stop.
3. The spoken words fill the search field.
4. In the main search section, the search runs as soon as the speech result is final. In the header search, the shopper submits the query.

Recognition uses the language set for the store page, so set the store language before you test it.