Autocomplete

Use GdsAutocomplete when the user must pick one or more values from a known list - states, assignees, tags, categories. They can type to filter options instead of scrolling a long native <select>.

Always wire the input through GdsTextField with renderInput so the field gets a label, helper text, and error styling like every other GDS input.

Default

A single-select field with a label, placeholder, and helperText on the nested GdsTextField.

Multiple selection

Set multiple when the user can pick more than one value. Selected items render as chips inside the field.

Free solo

Set freeSolo to allow values that are not in options - useful for tags or custom labels.

Grouped options

Use groupBy (and usually getOptionLabel) when options should appear under section headings.

Sizes

Use size on GdsAutocomplete for small or medium. Autocomplete passes size into renderInput and also sizes chips in multiple mode.

States

Pass disabled on Autocomplete, or error / helperText on the nested GdsTextField, for common field states.

Props