> For the complete documentation index, see [llms.txt](https://guides.noloco.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.noloco.io/data/collections/field-types/single-option-select.md).

# Single Option Select

Single Option Select fields permit selection from a predefined list of options and are useful when assigning categories or status values. A typical value could be 'In Progress'. These fields can be displayed as dropdown or radio buttons, and the list of options is fully customizable to match your needs, offering flexibility in options, option order, and the color of each individual option.

You can bulk-add options by pasting in a list of your options.

## Display Options

* **Dropdown** Shows options in a dropdown menu (default)
* **Radio Buttons** Shows all options as radio button selections
* **Colored Options** Like the default dropdown, but options appear as colored badges

## Configuration Options

* **Custom Options** Add, remove, and reorder options to match your workflow
* **Badge Style** Choose how option badges look everywhere they appear — in the data grid, forms, and filter chips:
  * **Light** (default) — pastel background with colored text
  * **Contrasted** — solid color background with white text
* **Option Colors** Assign a color to each option for visual distinction. Each option shows a badge-shaped chip with its order number — click it to pick from the preset color palette.
* **Default Value** Set which option is selected by default for new records

## Editing in the data grid

When a Single Option Select field is editable in the data grid (or in a table view with inline editing enabled), double-clicking a cell opens a popover editor. The popover contains a search input and the full list of available options.

### Selecting a value

Click any option to replace the current value. The popover closes and the cell updates immediately.

You can also navigate and select with the keyboard:

* **Type** to filter the option list. The first matching result is highlighted automatically.
* **↑ / ↓ arrow keys** to move through the list.
* **Enter** to select the focused option.

### Creating a new option inline

If no existing option matches what you typed, a **Create "…"** entry appears at the bottom of the list. Press **Enter** or click it to create and select the new option in one step. The new option is added to the field's option list and synced with the field's property panel.

### Managing options from the editor

Hover any option in the list to reveal the option menu icon (**⋮**). From here you can:

* **Rename** the option (edited inline)
* **Change the colour** of the option
* **Delete** the option (a confirmation modal appears before deleting)

These changes apply everywhere the option is used and are reflected in the field's property panel — no need to open field settings separately.

## Use Cases

Single Option Select fields are ideal for:

* Project status (Active, Completed, On Hold)
* Priority levels (High, Medium, Low)
* Categories and types
* Workflow stages
* Approval states
* Geographic regions or locations

## Best Practices

* Keep option names short and clear
* Use colors strategically (e.g., red for urgent, green for complete)
* Order options logically (by priority, chronologically, or alphabetically)
* Consider how the field will appear in different views and reports
* Use radio buttons when you have 2-4 options that users should see all at once


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://guides.noloco.io/data/collections/field-types/single-option-select.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
