> For the complete documentation index, see [llms.txt](https://docs.wem.io/platform/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wem.io/platform/wemtipsandtricks/widgets/advanced-input/single-select-input-button.md).

# Single select input button

This widget shows a set of options displayed as buttons based on a concept set, allowing a single button to be active (single select). This widget provides a excelent way to make filters that can only have one option selected and using the dynamic labels. 

<div data-full-width="true"><figure><img src="/files/AA3YA7jkpRtFsHnmgUbG" alt=""><figcaption></figcaption></figure></div>

### Properties

| Property          | Type                     | Description                                                                                                                                                                                                                                         |
| ----------------- | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Data field        | datafield, single select | This widget shows buttons for each available option (concept). It displays the selected option and all other options allowing the user to change the selected option.                                                                               |
| Options           | concept set              | Can be used to filter options (concepts) of 'data field', but is ignored when the provided concept set is empty. This widget does not show an option of the property 'data field' when it is not part of the provided concept set in this property. |
| On change         | dropdown                 | When the user clicks on an option (changing the datafield value), the following actions can be performed: do nothing, refresh screen or execute flowchart.                                                                                          |
| Execute flowchart | flowchart                | Execute the provided flowchart when the user clicks on one of the options. Only visible when 'On change ' is set to 'Execute flowchart'.                                                                                                            |
| Label             | text, expression         | Changes the button text. By default it displays the concept's name.                                                                                                                                                                                 |
| Image             | Image                    | Use an image as button label instead of using text.                                                                                                                                                                                                 |
| Badge             | Number, expression       | Display the buttons either horizontal or vertical. The option 'Buttons horizontal' is deprecated and should be ignored.                                                                                                                             |
| Orientation       | Dropdown                 | Display the buttons either horizontal or vertical. The option buttons horizontal is deprecated and should be ignored.                                                                                                                               |
| Justified         | Dropdown, boolean        | Make the buttons as wide as possible. Only visible when using a horizontal orientation.                                                                                                                                                             |

{% hint style="info" %}
*\*Example usage: The 'data field' of example 1 allows the user to select one of three options {Turquoise, Emerald and Peter River}. Using a smaller 'Options' concept set {Turquoise, Emerald} makes it possible to limit the number of options. In this example the user is not able to select the option Peter River.*
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wem.io/platform/wemtipsandtricks/widgets/advanced-input/single-select-input-button.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.