Dropdown

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.

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: Show every single-choice option without opening a menu.
• Multi-select: Collect more than one choice.
• Schema and validation: Keep option IDs stable across published versions.