--- layout: default title: "The SearchInput Component" storybook_path: ra-ui-materialui-input-searchinput--basic --- # `` In addition to [the usual input types](./Inputs.md) (``, ``, ``, etc.), you can use the `` in the [`filters` array](./List.md#filters-filter-inputs). This input is designed especially for the [Filter Form](./FilterForm.md). It's like a `` with a magnifier glass icon - exactly the type of input users look for when they want to do a full-text search. **Tip:** Prefer using [``](./FilterLiveSearch.md) component if you want to provide your users with a search feature in a [`` aside](./List.md#aside). ## Usage ```tsx import { SearchInput, TextInput, SelectInput } from 'react-admin'; const postFilters = [ , , , ]; export const PostList = () => ( ... ); ``` In the example given above, the `q` filter triggers a full-text search on all fields. It's your responsibility to implement the full-text filtering capabilities in your `dataProvider`, or in your API. ## Props | Prop | Required | Type | Default | Description | | ------------ | -------- | --------- | ------- | -------------------------------------------------------------------- | | `placeholder` | Optional | `string` | `Search` | Attribute for displaying default text in the `input` element | | `resettable` | Optional | `boolean` | `true` | If `true`, displays a clear button next to the input | `` also accepts the [common input props](./Inputs.md#common-input-props). Additional props are passed down to the underlying Material UI [``](https://mui.com/material-ui/react-text-field/) component. ## `placeholder` Replace the default `Search` placeholder by setting the placeholder prop: ```jsx ``` ## `resettable` You can disable the input reset feature by setting `resettable` to `false`: ```tsx ```