Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cognite.com/llms.txt

Use this file to discover all available pages before exploring further.

Combobox

v1.0.0 | View in Storybook

When to use

  • More than ~12 options, where typing to filter is faster than scrolling.
  • The user knows roughly what they’re looking for (e.g. selecting a country, an asset name, a tag).
  • Forms where users need to search and select from a predefined list.
  • When users need to add new options that don’t exist in the list yet.

When to use something else

  • Fewer than ~12 options: use Select, Radio, or Checkbox depending on context.
  • The user is unfamiliar with the available options and wouldn’t know what to type: a visible list is less intimidating.
  • Very large datasets where filtering may cause lag: consider a Data grid with toolbar filtering instead.
  • Free text input with no list to select from: use Input or Textarea.

Dos and don’ts

  • Do group related options if the list spans multiple categories.
  • Don’t use it for simple yes/no or small option sets: the search affordance implies more options than are there.

Behavior

  • Single-select: the menu closes immediately on selection.
  • Multi-select: the menu stays open until the user clicks outside, presses Escape, or presses Enter.

Combobox menu

Combobox menus display a checkmark, or toggle, to the right of the menu item, instead of on the left like traditional Context and Dropdown menus. This is because scanning the list is easier when the checkmark is on the right. Therefore it is recommended to avoid leading content like an icon or Badge on the left side of the menu item. Badges should be placed on the right side of the menu item.

Often used with

Last modified on May 11, 2026