# @vaadin/combo-box

> Web Component for displaying a list of items with filtering

Latest version **25.2.12** (published 2026-09-17) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @vaadin/combo-box
pnpm add @vaadin/combo-box
yarn add @vaadin/combo-box
bun add @vaadin/combo-box
```

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 25.2.12 |
| Published | 2026-09-17 |
| First published | 2021-10-08 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 10 |
| Unpacked size | 313.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 582 |
| Author | Vaadin Ltd |
| Maintainers | web-padawan, diegocardoso, alvarezguille, platosha, jouni, manolo, yuriyyev, vaadin-owner, tomivirkki, artur-, sunzhewyq, sissbruecker |
| Keywords | Vaadin, combo-box, web-components, web-component |

## Links

- npm: https://www.npmjs.com/package/@vaadin/combo-box
- Repository: https://github.com/vaadin/web-components
- Homepage: https://vaadin.com/components
- Issues: https://github.com/vaadin/web-components/issues
- npm.io page: https://npm.io/package/@vaadin/combo-box

## Dependencies (10)

- [lit](https://npm.io/package/lit.md) ^3.0.0
- [@vaadin/item](https://npm.io/package/@vaadin/item.md) ~25.2.12
- [@vaadin/overlay](https://npm.io/package/@vaadin/overlay.md) ~25.2.12
- [@vaadin/a11y-base](https://npm.io/package/@vaadin/a11y-base.md) ~25.2.12
- [@vaadin/field-base](https://npm.io/package/@vaadin/field-base.md) ~25.2.12
- [@vaadin/lit-renderer](https://npm.io/package/@vaadin/lit-renderer.md) ~25.2.12
- [@open-wc/dedupe-mixin](https://npm.io/package/@open-wc/dedupe-mixin.md) ^1.3.0
- [@vaadin/component-base](https://npm.io/package/@vaadin/component-base.md) ~25.2.12
- [@vaadin/input-container](https://npm.io/package/@vaadin/input-container.md) ~25.2.12
- [@vaadin/vaadin-themable-mixin](https://npm.io/package/@vaadin/vaadin-themable-mixin.md) ~25.2.12

## Recent versions

- 25.2.12 (latest) — 2026-09-17
- 25.3.0-rc1 (next) — 2026-09-16
- 25.3.0-dev.1fa5a51482 (dev-disable-dates) — 2026-07-25
- 24.4.0-dev.4b20a0c55.3 (canary) — 2024-03-22
- 25.3.0-beta3 — 2026-09-11
- 25.2.11 — 2026-09-11
- 25.1.14 — 2026-09-11
- 25.3.0-beta2 — 2026-09-07
- 23.6.6 — 2026-09-07
- 25.2.10 — 2026-09-03
- 25.1.13 — 2026-09-03
- 24.10.6 — 2026-09-03
- 24.9.18 — 2026-09-01
- 25.3.0-beta1 — 2026-08-31
- 25.2.9 — 2026-08-26
- … 635 more at https://npm.io/package/@vaadin/combo-box/versions

## README

# @vaadin/combo-box

A web component for choosing a value from a filterable list of options presented in an overlay.

[Documentation + Live Demo ↗](https://vaadin.com/docs/latest/components/combo-box)

[![npm version](https://badgen.net/npm/v/@vaadin/combo-box)](https://www.npmjs.com/package/@vaadin/combo-box)

```html
<vaadin-combo-box
  label="User"
  placeholder="Please select"
  item-value-path="email"
  item-label-path="email"
></vaadin-combo-box>

<script>
  const comboBox = document.querySelector('vaadin-combo-box');

  fetch('https://randomuser.me/api?results=100&inc=name,email')
    .then((res) => res.json())
    .then((json) => (comboBox.items = json.results));
</script>
```

[<img src="https://raw.githubusercontent.com/vaadin/web-components/main/packages/combo-box/screenshot.png" width="208" alt="Screenshot of vaadin-combo-box">](https://vaadin.com/docs/latest/components/combo-box)

## Installation

Install the component:

```sh
npm i @vaadin/combo-box
```

Once installed, import the component in your application:

```js
import '@vaadin/combo-box';
```

## Contributing

Read the [contributing guide](https://vaadin.com/docs/latest/contributing) to learn about our development process, how to propose bugfixes and improvements, and how to test your changes to Vaadin components.

## License

Apache License 2.0

Vaadin collects usage statistics at development time to improve this product.
For details and to opt-out, see https://github.com/vaadin/vaadin-usage-statistics.

---
_Source: https://npm.io/package/@vaadin/combo-box · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._