> For the complete documentation index, see [llms.txt](https://docs.labii.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.labii.com/widgets/column-widgets/form/dropdown/selectoption.md).

# SelectOption

Display all configured options for selecting a single value

## **Specs**

| Label                     | Value                         |
| ------------------------- | ----------------------------- |
| **Version**               | 1.0.0 (updated on 2026-08-22) |
| **Developer**             | Labii Inc.                    |
| **Type**                  | Column                        |
| **Support Configuration** | Yes                           |
| **Support Readonly view** | Yes                           |
| **Support Edit view**     | Yes                           |
| **Support Form view**     | Yes                           |
| **Support Default value** | Yes                           |
| **Support Import**        | Yes                           |
| **Allow multiple**        | Yes                           |

## Overview

The Labii SelectOption widget allows users to select one value from a custom list of options. It provides the same configuration, data handling, and functionality as the [Select widget](/widgets/column-widgets/form/dropdown/select.md), but displays all available choices directly in the Edit and Form views instead of placing them inside a dropdown. This layout lets users review and select an option with a single click.

## Use case

1. Use this widget to select a protocol type from a list that should remain visible.
2. Use this widget to define the status of a project when users need to compare all available statuses at a glance.

## Configuration

To enable the widget's functionality, provide a list of options. Each option can include the following fields:

* **Dropdown option** - The value displayed to users.
* **Color** - The color used to highlight the option.
* **Should include additional input** - When enabled, selecting the option displays an additional input field. Do not include `()` in the option name.

### Example

```json
[
    {
        "option": "Male",
        "color": "#000000"
    },
    {
        "option": "Female",
        "color": "#010101"
    }
]
```

## Views

See the interface of the widget in the following views.

### **Readonly view**

The Readonly view displays the selected value in the same way as the Select widget.

<figure><img src="https://3607108856-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LHVg57XIRcjV-Vbubtn%2Fuploads%2Fgit-blob-fe3e285a09ca43766be7fbb30f01634669502737%2Fwidget-column-select-readonly.webp?alt=media" alt=""><figcaption></figcaption></figure>

### **Edit view**

The Edit view displays all configured options as a visible list. Select an option to update the column value.

<figure><img src="https://3607108856-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LHVg57XIRcjV-Vbubtn%2Fuploads%2Fgit-blob-b8158ad0644454262dd510a2bc9b8093ada83f70%2Fwidget-column-selectoption-edit.webp?alt=media" alt=""><figcaption></figcaption></figure>

When **Should include additional input** is enabled for an option, selecting that option displays an additional input field for collecting the required value.

### **Form view**

The Form view is the field integrated into the add form for collecting values when creating a new record.

The Form view is the same as the Edit view.

## Data

Each widget in Labii stores data in a unique manner; refer below to understand how data from this widget is stored.

### Data format

The selected option is stored as a string.

### **Default value**

The Default Value field within the column allows you to specify the default value when a record is created.

The default value must be an option value in string format.

### **Import value**

The Import Value is the value you need to include in your Excel table for it to be imported into Labii.

The import value must be an option value in string format.
