> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superoffice.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List box

> List box

This element adds a drop-down menu to your screen.

## Configuration

| Setting            | Description                                            |
| :----------------- | :----------------------------------------------------- |
| label              | UI label of the list                                   |
| options.length     | The number of items                                    |
| options.n.value    | UI label of option                                     |
| options.n.name     | ID of option                                           |
| options.n.selected | Sets the nth option as selected by default (v. 7.5SR1) |
| JavaScript         | HTML code                                              |

## Example

```html theme={null}
JavaScript = onblur="alert('Wow! You changed it!');"
```

## Functions

### setFieldValue(String action, Map values) (v.7.0 SR1)

| Action | Map keys        | Description                              |
| :----- | :-------------- | :--------------------------------------- |
| add    | name<br />value | Adds an option                           |
| remove | value           | Removes all options with the given value |
| clear  |                 | Removes all options                      |

### toString()

Converts the selected value to a string.

### toInteger()

Converts the selected value to a number.


## Related topics

- [How to set a user-defined list item on a Udef field (services)](/en/api/web-services/howto/custom-objects/set-udef-listitem-value.md)
- [Lists](/en/api/lists/index.md)
- [User-defined lists](/en/admin/lists/user-defined-lists.md)
- [Create SMS mailbox](/en/email/admin/mailbox/create-sms-mailbox.md)
- [Add Follow-up type](/en/diary/admin/add-follow-up-type.md)
- [Users](/en/admin/user-management/index.md)
- [Add external applications](/en/customization/admin/other-applications.md)