--- title: Checkbox and Select Inputs label: Checkbox and Select Inputs order: 60 desc: Build custom boolean and option controls with Payload's CheckboxInput and SelectInput components. keywords: ui, components, checkbox input, select input, options, custom field --- `CheckboxInput` and `SelectInput` provide the input-level controls used by Payload's Checkbox and Select fields. They are useful when a Custom Field needs standard Admin styling while controlling its own state. ## Import ```tsx import { CheckboxInput, SelectInput } from '@payloadcms/ui' ``` ## CheckboxInput Use `checked` and `onToggle` to control the value. Set `partialChecked` to display the indeterminate treatment used by list-selection interfaces. ## SelectInput `SelectInput` wraps [`ReactSelect`](/docs/ui-components/react-select) with Payload's field label, description, and validation structure. Its controlled `value` contains the stored option value rather than the complete option object. ## CheckboxInput props | Prop | Type | Default | Description | | ---------------- | -------------------------------------- | ------- | ------------------------------------------ | | `checked` | `boolean` | `false` | Controls the checked state. | | `onToggle` \* | `ChangeEventHandler` | — | Receives changes from the native checkbox. | | `label` | `StaticLabel` | — | Displays the checkbox label. | | `partialChecked` | `boolean` | `false` | Displays the indeterminate treatment. | | `readOnly` | `boolean` | `false` | Disables interaction. | | `required` | `boolean` | `false` | Marks the native input as required. | ## SelectInput props | Prop | Type | Default | Description | | ------------- | ---------------------- | ------- | --------------------------------------------- | | `name` \* | `string` | — | Names the select input. | | `path` \* | `string` | — | Identifies the field and connects its UI. | | `options` \* | `OptionObject[]` | — | Supplies the available translated options. | | `value` | `string \| string[]` | — | Supplies the selected stored value or values. | | `onChange` | `ReactSelect.onChange` | — | Receives the selected option object. | | `hasMany` | `boolean` | `false` | Enables multiple values. | | `isSortable` | `boolean` | `true` | Enables reordering in multi-value mode. | | `isClearable` | `boolean` | `true` | Allows the selected value to be cleared. | | `readOnly` | `boolean` | `false` | Disables interaction. | | `showError` | `boolean` | Form | Displays the current validation error. | _\* An asterisk denotes that a prop is required._ ## Provider requirements Both inputs use Payload's translation context. `SelectInput` also composes the standard field label, description, and error components, which can read the surrounding form context in a Custom Field.