# Button Group

Buttons. Create some options and let your users select one and only one. May they choose wisely.


## Overview

The button group fieldtype is a multiple choice input where you only get one choice. It saves the chosen option from a preset list.

## Configuring

Use the `options` setting to define a list of values and labels.

``` yaml
seat_choice:
  type: button_group
  instructions: Choose your airline seat. Choose wisely.
  options:
    left: Left
    middle: Middle
    right: Right
```

You may omit the labels and just specify keys. If you use this syntax, the value and label will be identical.

``` yaml
  options:
    - Left
    - Middle
    - Right
```

### Options in blueprint YAML

Like the [select](/fieldtypes/select.md) fieldtype, `options` in the blueprint are saved in **expanded** form (ordered `key` / `value` rows) so option order is preserved in all storage backends. Hand-written blueprints should follow that structure if you are not using the visual editor.

```yaml
options:
  - key: left
    value: Left
  - key: middle
    value: Middle
```

## Data Structure

The chosen option is stored as a string. If you only specified values for the `options` array, then the label will be saved.

``` yaml
seat_choice: middle
```



## Templating

It's a string, so you can just use that value.

::tabs

::tab antlers

```
<p>I love sitting in the {{ seat_choice }} seat. A lot.</p>
```

::tab blade

```blade
<p>I love sitting in the {{ $seat_choice }} seat. A lot.</p>
```

::

```html
<p>I love sitting in the middle seat. A lot.</p>
```