Edit documentation Edit document

Radio Button

Radio Button is a gh-element that allows to add the set of different buttons and select one of them. Also, you can customize the buttons.

Functional Characteristics

This useful item allows you to set any status for items. It is also used to configure other elements, such as the task board or filter tabs, and to easily filter items in gh-elements such as table, cards, etc.

Value Format

The value of the radio button is an ID of the option selected by user. It can only be one in the element. The value can be selected in the drop-down list.

    "field_value": "4"

Element Options

Radio button has three sets of options. One of them relate to field, others to values.

Field Settings

All field settings that you can configure are standard for all gh-elements. About them you can read in Setting Overview.

Settings of radio button field

Options Settings

These settings allows to add, update, and delete options of the value.

Settings of radio button options

Name Description
Name field that allows to enter the name of the option; detail...
Color allows to select the color of the button; detail...
Edit contains buttons for updating and deleting existed options; detail...


The name of the option is the name that will be displayed on the button.


The color button allows to open the color picker and select the color of the option.


This column contains the buttons for editing and deleting options.

Default Value Settings

The group of settings that configure the default value:

Settings of radio button default value

Name Description
Use default value allows to take advantage the default value; details...
Default value allows you to select the variant of the value that will be used by default; details...

Use Default Value

This setting allows you to use the default value of this element.

Default Value

This setting allows you to enter the value that will be used as a default value.

Element Style

The radio button element has all standard style settings that you may have already seen in Setting Overview. Also, it has a list of interpretation types those are described below.

Element style of radio button

Data Model

The whole uniqueness of its data model lies in the array of options.

        "interpretation": [],
        "options": [{
            "name": "In Process", 
            "value": 0, 
            "color": "#FF0000"
        "use_default_value": false
Name Type Description
interpretation array contains all element interpretation types
options array contains all data of every option
name string contains options name
value number unique ID of element options in the element
color string contains hex code of the selected color
use_default_value boolean shows whether a default value is used


Radio button fields can be filtered out by filters that deal with full values:


A most interpretation types of voting element has color text, background, or the both. The color of each option is set in the Field Settings.

Types of radio button interpretation

Input With Name

This interpretation allows to display value options as rectangular blocks with strongly rounded conners. The selected option is displayed in a color background and with the white text.


Due to this interpretation the value options are displayed as rectangular blocks with slightly rounded corners. The unselected option is displayed as a color text on the white background. The selected one is contrary, white text on the color background.


This is a type that allows to display the only selected value with color background and white text. The shape of value block is rectangular blocks with strongly rounded conners.


The selected value is displayed as rectangular blocks with slightly rounded conners, color background and white text.


This is the interpretation type that displayed only the selected value as an uneditable text.


The last interpretation type displays the selected value of the element.