---
url: https://gudhub.com/uk/docs/gh-elements/options-element/
title: "Options Element\n                #"
description: "Options is a gh element that allows you to create a static list of possible values. Then users can select one or more of these values to fill the field. If the"
lang: uk
updated: 2026-09-11T12:39:35.286Z
---

# Options Element [#](https://gudhub.com/uk/docs/gh-elements/options-element/#options-element)

**Options** is a gh-element that allows you to create a static list of possible values. Then users can select one or more of these values to fill the field. If the user has certain access, he can update the list in [options settings](#options-settings). This element can be used for filling in the invoice or registration form.

It looks very similar to a [text field](https://gudhub.com/uk/docs/gh-elements/text/). But its its functionality consists of input field and drop-down list.

![Element example](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/options-drop-down.gif "Options field")

Since it has a list of existing values, the user just needs to find the right one. The **Text Options** allows the user to find the required value by entering a part of it. In other words, the element input field works like a search field for its own dropdown list.

![Entering the search request](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/options-search-value.gif "Searching value")

> Note that _to select a value_ you must **click on it**. You cannot just type a value.

## Functional Characteristics [#](https://gudhub.com/uk/docs/gh-elements/options-element/#functional-characteristics)

The main use of the current element is to create fields with a limited and unchanging set of values that can be used to fill it. This field is useful for various forms, to set the status or project of a task, a position in the company, or a favorite time of year.

> That is, text options are suitable for limiting users so that they cannot enter their own data, but only choose from the available ones.

Also, depending on the [settings](#field-settings), **Text Options** can be used to label product by characteristics or track any processes.

## Element Options [#](https://gudhub.com/uk/docs/gh-elements/options-element/#element-options)

The options element contains two groups of settings. The first one configures the field while the second one configures its values.

### Field Settings [#](https://gudhub.com/uk/docs/gh-elements/options-element/#field-settings)

These settings contains all standard and unique field options.

![Settings of options field](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/options-field-settings.jpg "Options field settings")

| Name | Description |
| :-- | :-- |
| Multiple value | allows to select and save a multiple value; [detail...](#multiple-value) |
| Multiple selection | allows to duplicate selected values; [detail...](#multiple-selection) |

#### **Multiple value** [#](https://gudhub.com/uk/docs/gh-elements/options-element/#multiple-value)

The current mode allows the user to select several unique options simultaneously. That means that field will display all selected values as a different boxes.

![Example of multiple value](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/options-multiple-value.jpg "Multiple value")

The method of choosing an option from list is unchanged. But before the user can select any option, he/she must open the input field by clicking on the **Add option** button.

![Filling the options field](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/options-select-value.gif "Value selecting")

As in the standard mode, you can find the option you need by entering part of its text in the search field.

![Searching and selecting](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/options-search-multiple-value.gif "Search for a value")

To delete value user just have to click the delete button that appears in the end of the field when the cursor is hovered on the particular value.

![Deleting of multiple values](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/options-values-deleting.gif "Value deleting")

> The current feature allows you to use the element both to mark all product characteristics and to list all former employee positions.

#### **Multiple selection** [#](https://gudhub.com/uk/docs/gh-elements/options-element/#multiple-selection)

This setting was created as a complement to the [Multiple Value](#multiple-value). Its main purpose is allow users to add a few similar values to the field.

![Selecting the same values](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/options-multiple-selection.gif "Multiple selection")

> This feature cannot work without **Multiple Value** enabled.

This mode allows the you to track sequential repetitive actions. For example, you can use it to track actions with a sent email.

### Options Settings [#](https://gudhub.com/uk/docs/gh-elements/options-element/#options-settings)

This group of settings allows to configure options of each of values.

![Settings of options](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/options-settings.jpg "Options settings")

| Name | Description |
| :-- | :-- |
| Name | column that contains names of the selection options; [detail...](#name) |
| Edit | column where delete and edit buttons are located; [detail...](#edit) |

#### **Name** [#](https://gudhub.com/uk/docs/gh-elements/options-element/#name)

The current column contains the text of all available options. You enter each of them yourself. That allows you to create unique set of values for different needs. This can be a list of names, projects, or product characteristics.

> Two or more options with the same text are considered **different options**, not duplicates.

#### **Edit** [#](https://gudhub.com/uk/docs/gh-elements/options-element/#edit)

The second column provides two buttons for every option. One of these buttons, which looks like a pencil, allows you to change the text of an option. The other, in the form of a trash can, allows you to remove the option altogether.

### Default Value Settings [#](https://gudhub.com/uk/docs/gh-elements/options-element/#default-value-settings)

These settings allows to configure default value of the options elements.

![Settings of options default value](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/options-default-value-settings.jpg "Options default value settings")

| Name | Description |
| :-- | :-- |
| Use default value | allows to set whether default value will be used or not; [details...](#use-default-value) |
| Default value | allows to enter the default value; [details...](#default-value) |

#### **Use Default Value** [#](https://gudhub.com/uk/docs/gh-elements/options-element/#use-default-value)

This is the option that allows you to use the default value for _option field_. This means that if the user does not fill in the current field when creating a new item, it will be filled with the [default value](#default-value).

> Even if this [default value](#default-value) exists, it will not be used if **Use Default Value** is disabled.

#### **Default Value** [#](https://gudhub.com/uk/docs/gh-elements/options-element/#default-value)

The **Default Value** is a value that is the value that will be used to fill the field when creating a new item. But it will be used only if the _option field_ was **not filled** in when the element was created.

> It will be used only if the [Use default value](#use-default-value) is enabled.

## Element Style [#](https://gudhub.com/uk/docs/gh-elements/options-element/#element-style)

The options element has three groups of style settings. The first two groups are the standard one. About them you can read in [Setting Overview](https://gudhub.com/uk/docs/understanding-gudhub/gh-elements-structure/setting-overview/). And the third one is a list of [interpretations](#interpretation).

![Style of options element](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/options-element-style.jpg "Options element style")

## Filtration [#](https://gudhub.com/uk/docs/gh-elements/options-element/#filtration)

-   [Equals(or)](https://gudhub.com/uk/docs/core-api/filter/equals/)
-   [Equals(and)](https://gudhub.com/uk/docs/core-api/filter/equals/)
-   [Not equals(or)](https://gudhub.com/uk/docs/core-api/filter/equals/)
-   [Not equals(and)](https://gudhub.com/uk/docs/core-api/filter/equals/)
-   [Value](https://gudhub.com/uk/docs/core-api/filter/value/)
-   Checkbox list(and)
-   Checkbox list(or)

## Interpretation [#](https://gudhub.com/uk/docs/gh-elements/options-element/#interpretation)

The current element has three different types of interpretation.

![Types of options interpretation](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Gh_Elements/gh-elements/options-interpretation-types.jpg "Options interpretation types")

### Default [#](https://gudhub.com/uk/docs/gh-elements/options-element/#default)

The default interpretation type of options element is an editable field that allows to choose on of set values. There are two ways to choose:

-   Select value in popup list
-   Enter value name in the field

### Plain Text [#](https://gudhub.com/uk/docs/gh-elements/options-element/#plain-text)

This is interpretation with uneditable string of the selected value.

### Value [#](https://gudhub.com/uk/docs/gh-elements/options-element/#value)

The last interpretation type displays the selected value.

## Value Format [#](https://gudhub.com/uk/docs/gh-elements/options-element/#value-format)

Each of the options has its own value, which is a sequential number obtained immediately after adding an option to the list.

Копіювати

```json
{
    "field_value": "0"
}
```

## Data Model [#](https://gudhub.com/uk/docs/gh-elements/options-element/#data-model)

The options element has a rather complex data model.

Копіювати

```json
{
    "data_model":{
        "default_field_value": 0,
        "interpretation": [],
        "max_value": "1",
        "multiple_selection": 1,
        "multiple_value": false,
        "options": [{
            "name": "Out of Stock",
            "value": 0
        }],
        "use_default_value": false
    }
}
```

| Name | Type | Description |
| :-- | :-- | :-- |
| default\_field\_value | `number` | _shows which value is default_ |
| interpretation | `array` | _contains all element interpretation types_ |
| max\_value | `string` | _contains the ID of the last value_ |
| multiple\_selection | `boolean` | _shows whether the multiple selection is used_ |
| multiple\_value | `boolean` | _shows whether the element accepts multiple values_ |
| options | `array` | _contains all options from array of variants_ |
| name | `string` | _contains name of the option_ |
| value | `number` | _contains the unique ID of the value option in the element_ |
| use\_default\_value | `boolean` | _shows whether the default value is used or not_ |