---
title: "Dropdown"
description: "Collect one choice in a compact dropdown control."
group: "Build forms"
order: 8
type: "reference"
parent: "fields"
keywords:
  - "dropdown"
  - "options"
  - "select"
updated: "2026-07-14"
---

The dropdown field presents a compact list and stores one option ID.

## Options and validation

Dropdowns use the same `options`, `allowOther`, and `shuffleOptions` schema as select fields. Each option has a stable `id` and a visible `label`. A required dropdown rejects an empty answer or an ID that isn't in the current option list.

When `allowOther` is true, an unlisted free-text answer is valid and is stored directly. The `icon` option is meant for the visible select renderer; it doesn't change a dropdown.

## Add a dropdown field

In the dashboard, select **Add block**, choose **Dropdown**, and add options. The editor currently manages options as form data — there's no separate remote-option or searchable-data-source contract.

```ts
const departmentField = {
  id: "department",
  kind: "dropdown",
  label: "Department",
  options: [
    { id: "engineering", label: "Engineering" },
    { id: "product", label: "Product" },
    { id: "support", label: "Support" },
  ],
} as const;
```

## Related

- [Select](/docs/fields/select): Show every single-choice option without opening a menu.
- [Multi-select](/docs/fields/multi-select): Collect more than one choice.
- [Schema and validation](/docs/schema): Keep option IDs stable across published versions.