# Search input

<figure><img src="https://3723856256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGnixyIfIYFWroNtVmZo6%2Fuploads%2Fgit-blob-95ec1d79b1015edec0054bbb14d6f0013e0bfe1c%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Overview

A customizable search form component that provides a responsive search interface with various styling and layout options. Features include configurable button display, search overlay support, and flexible padding controls.

## Common use cases

* Use small size for header/navigation integrations
* Enable search overlay for a more immersive search experience
* Consider showing the search button for better accessibility on mobile devices
* Match button color scheme with your site's design system
* Adjust padding settings based on surrounding content

## Block settings

### General

| Setting                | Description                 | Options                   |
| ---------------------- | --------------------------- | ------------------------- |
| Show advanced settings | Reveals visibility settings | Checkbox (default: false) |

### Content

| Setting               | Description                                       | Options                                                                                                                                                              |
| --------------------- | ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Placeholder           | Placeholder text for the search input             | Text input (default: Search for product)                                                                                                                             |
| Enable search overlay | Opens search results in an overlay when enabled   | Checkbox (default: true)                                                                                                                                             |
| Show button           | Displays a submit button next to the search input | Checkbox (default: false)                                                                                                                                            |
| Button label          | Label text for the search button                  | <p>Text input (default: Search)<br><br>Visible when show button is true</p>                                                                                          |
| Button color          | Color scheme for the search button                | <p>• Primary<br>• Secondary (default)<br>• Tertiary<br>• Neutral<br>• Plain<br>• Outline<br>• Inverted outline<br>• Blur<br><br>Visible when show button is true</p> |
| Layout                | Controls the layout of input and button           | <p>• Stacked<br>• Inline (default)<br><br>Visible when show button is true</p>                                                                                       |

### Spacing

| Setting                   | Description                                    | Options                   |
| ------------------------- | ---------------------------------------------- | ------------------------- |
| Enable horizontal padding | Adds horizontal padding around the search form | Checkbox (default: false) |
| Enable top padding        | Adds top padding around the search form        | Checkbox (default: false) |
| Enable bottom padding     | Adds bottom padding around the search form     | Checkbox (default: false) |

### Style

| Setting | Description                           | Options                                         |
| ------- | ------------------------------------- | ----------------------------------------------- |
| Size    | Controls the size of the search input | <p>• Small<br>• Medium (default)<br>• Large</p> |

### Display

| Setting    | Description                        | Options                                                                                                                            |
| ---------- | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Visibility | Controls when the block is visible | <p>• All (default)<br>• Mobile only<br>• Desktop only</p><p><br><br>Visible when <strong>Show advanced settings</strong> is on</p> |