Skip to content

Searchable dropdown

A searchable dropdown lets users type to filter a long list of options and select one of them.

  • CSS

Maintained by Platform

Usable — may still change

The searchable dropdown is an input-driven selection component that combines a text field with a filterable list of options. Users type to narrow down a long list and select one item from the filtered results. It handles large or dynamic option sets where scrolling through a static list would be impractical, and it bridges the gap between a free-text input and a standard dropdown: the search is fast and intuitive, but only a value from the predefined set can be selected.

Start typing to filter the list.
  • Madrid
  • Milan
  • No results found, please try another city.
  1. Label
  2. Text area
  3. Icon
  4. Helper text
  5. List
  6. No results

Use a searchable dropdown when:

  • The list holds more than 7–10 options and scrolling the full list would be tedious.
  • The options come from a dynamic or API-driven source (for example countries, users or product names).
  • The user likely knows, or can partially recall, the value they are looking for.
  • Keyboard-first users prefer to type rather than click.
  • Typeahead adds meaningful value to the task flow.

Avoid it when:

  • The list has fewer than 5–7 options — a dropdown or radio group is clearer and faster.
  • All options need to be visible at once for comparison — use a list or segmented control.
  • The input accepts free text that isn’t limited to a predefined set — use a plain field or a search field.
  • The choice is a simple yes or no — use a toggle, checkbox or radio.
  • The context is a mobile form with little vertical space — check whether a native select or a bottom sheet picker works better.

Search field vs searchable dropdown vs dropdown

Section titled “Search field vs searchable dropdown vs dropdown”

Must the user select from a predefined, closed list?

If no, use a search field.

Are there more than 7–10 options in that list?

If no, use a dropdown or radio buttons.

Does the user know the name of what they are looking for beforehand?

If yes, use a searchable dropdown. If no, use a categorized dropdown or a modal or picker.

Label

Identifies the expected data. It sits inside the empty field and moves to the top-left corner, smaller, once the field is active or holds a value — the same behaviour as the Field.

Text area

Holds the query while the user types, and the selected option once one is chosen. While the field is active and empty it shows a placeholder that says what can be searched for.

Icon

The chevron in the trigger. It points down while the list is closed and flips up while it is open.

Helper text

Optional supporting text under the field, with or without an icon.

Required

A required field shows a red asterisk next to its label.

Error

When the user leaves a required field empty, the field turns to its error state and the helper text is replaced by the error message and the instructions to solve it, with the error icon.

State

Rested, Hover, Active, Focus, Error and Disabled, each empty or filled. Active opens the list; Focus highlights the field for keyboard users; Disabled shows the field but makes it non-interactive, for example until a previous step is completed.

List

A floating List of options opens under the field while it is active. As the user types, the list narrows to the matching options and the best match is highlighted. When nothing matches, the list shows a single “No results” row.

Width

Set the width to the expected length of the content. The content never grows the field: the container masks the text.

Text overflow

The value stays on one line. At rest, text past the edge ends in an ellipsis. While active, the text scrolls so the cursor stays visible.

  1. The user clicks the field and the list opens.
  2. The user types, the list filters, and the best match is highlighted.
  3. The user selects an option. The list closes and the field is filled.
  4. If the user leaves a required field empty, it shows its error.

When the field already holds a value, the user can browse the list as normal; the value only changes once a new option is selected.

Do

Provide relevant choices, and let users browse the list without typing anything. Keep the list in step with the search, so users can see why each result appears. Always show a clear message when nothing matches.

Don't

Don’t make the list items wider than the field. Don’t use it for short lists — use a dropdown or radio buttons instead. Don’t show so many options at once that the screen feels crowded, especially on mobile.