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

# Segmented button

> It allows you to pick only one option from a group of options, and you can choose to have between 2 and 5 options in the group. The segmented button helps improve usability in your app.

![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/building-blocks/ui-designer/segmented_button1.gif)

## Configuring the segmented button

### Segmented button generic settings

The available configuration options for this form element are:

* [**Process data key**](#process-data-key)
* [**Properties**](#properties)
* [**Datasource**](#datasource-configuration)
* [**Validators**](#validators)
* [**Event handlers**](#event-handlers)
* [**Expressions**](#expressions)
* [**Segmented button styling**](#segmented-button-style-overrides-options)

#### Process data key

Process data key establishes the binding between the segmented button and process data, enabling its later use in [decisions](https://docs.flowx.ai/6.x/docs/building-blocks/node/exclusive-gateway-node.md), [business rules](https://docs.flowx.ai/6.x/docs/building-blocks/actions/business-rule-action/business-rule-action.md) or [integrations](https://docs.flowx.ai/6.x/docs/building-blocks/node/message-send-received-task-node.md).

#### Properties

* **Label**: The visible label for the segmented button.
* **Helpertext**: Additional information about the segmented button, which can be optionally hidden within an infopoint.

#### Datasource configuration

* **Default value**: The option selected when the segmented button first renders. Type the value of one of the options defined below.
* **Options** → **Add new** (+): Define label and value pairs here. The options are always static, so there is no source type to choose. The group needs at least 2 and at most 5 options.

#### Validators

The following validators can be added to a segmented button: `required`, `customExpression` and `custom`. For more information, see the [validators documentation](https://docs.flowx.ai/6.x/docs/building-blocks/ui-designer/validators.md).

![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/segmented-button-props.png)

#### Event handlers

Event handlers can be added to the segmented button element to define its behavior and interactions.

* **Trigger**: **On change** (`CHANGE`).
* **Action type**: Select the action type.

> [!TIP]
>
> For more information, see the [Event Handlers documentation](https://docs.flowx.ai/6.x/docs/building-blocks/ui-designer/event-handlers.md).

#### Expressions

Use JavaScript expressions to hide or disable the segmented button:

* **Hide condition**: Hides the segmented button when the expression evaluates to true.
* **Disable condition**: Disables the segmented button when the expression evaluates to true.

### Segmented button settings overrides

There are instances where you may need to tailor settings configured in the **Generic** settings tab. This proves especially beneficial when you wish to adjust these settings to appear differently across various platforms such as Web, Android, or iOS.

Available override settings:

* Properties:
  * **Label**: Override the segmented button label.
  * **Helper**: Override helper text/info point.
* Expressions:
  * **Hide**: Override the hide expression.

> [!TIP]
>
> To reuse settings overrides on another platform, open the ⋮ menu next to **\<platform> overrides** and pick **Copy from \<platform>** or **Copy to \<platform>**:
>
> ![The ⋮ menu next to Web overrides, listing Copy from Android, Copy from iOS, Copy to Android and Copy to iOS](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/6.x-settings-overrides-copy-menu.png)

> [tab] Web
>
> > [tab] Sizing
> >
> > Adjusting the size of components is crucial for a responsive design. Fit W (width) offers three options:
> >
> > * **Fill**: Fills the available space.
> > * **Fixed**: Maintains a fixed width.
> > * **Auto**: Adjusts the width automatically based on content.
>
> > [tab] Spacing
> >
> > Set the margin (space around the segmented button) and padding (space inside it) on each side.
>
> > [tab] Grid child
> >
> > Shown only when the segmented button sits inside a grid container: **Col span**, **Row span**, **Order** and **Alignment** set how the segmented button is placed in the parent grid.

> [tab] iOS
>
> Similar styling considerations apply to iOS as for web.

> [tab] Android
>
> Similar styling considerations apply to Android as for web.

#### Segmented button style overrides options

Theme overrides refer to the ability to modify or customize the appearance and behavior of UI components by overriding default theme settings. This can be applied at various levels, such as specific elements or entire sections, and can be platform-specific (Web, iOS, Android).

![Segmented button Theme overrides section in the Styles tab with every override category added](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/segmented-button-theme-overrides.png)

Style options:

> [accordion] Common Properties
>
> * Border radius **\[NUMBER]**
> * Border width **\[NUMBER]**
> * Font **\[FONT]**

> [accordion] Label
>
> * Default state
>   * Text **\[COLOR]**
> * Disabled state
>   * Text **\[COLOR]**
> * Font **\[FONT]**

> [accordion] Helper
>
> * Text **\[COLOR]**
> * Font **\[FONT]**
> * Helper tooltip
>   * Font **\[FONT]**
>   * Text **\[COLOR]**
>   * Background **\[COLOR]**
>   * Icon **\[COLOR]**

> [accordion] Error
>
> * Text **\[COLOR]**
> * Font **\[FONT]**

> [accordion] Unselected state
>
> * Border **\[COLOR]**
> * Background **\[COLOR]**
> * Text **\[COLOR]**

> [accordion] Selected state
>
> * Border **\[COLOR]**
> * Background **\[COLOR]**
> * Text **\[COLOR]**

> [accordion] Disabled Unselected state
>
> * Border **\[COLOR]**
> * Background **\[COLOR]**
> * Text **\[COLOR]**

> [accordion] Disabled Selected state
>
> * Border **\[COLOR]**
> * Background **\[COLOR]**
> * Text **\[COLOR]**

> [accordion] Hover unselected state (only for Web configuration)
>
> * Border **\[COLOR]**
> * Background **\[COLOR]**
> * Text **\[COLOR]**

> [accordion] Hover selected state (only for Web configuration)
>
> * Border **\[COLOR]**
> * Background **\[COLOR]**
> * Text **\[COLOR]**

> [!NOTE]
>
> On iOS, **Common Properties** offers only **Font**, and the only states are **Unselected state** and **Selected state**, each with **Background** and **Text**.

> [!NOTE]
>
> To reuse theme overrides on another platform without configuring them again, open the ⋮ menu next to **Theme overrides** and pick **Copy from \<platform>** or **Copy to \<platform>**.
>
> ![The ⋮ menu next to Theme overrides, listing Copy from Android, Copy from iOS, Copy to Android and Copy to iOS](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/6.x-theme-overrides-copy-menu.png)


## Related topics

- [Creating a user interface](https://docs.flowx.ai/6.x/docs/flowx-designer/managing-a-project-flow/creating-a-user-interface.md)
- [FlowX.AI 5.1.1 Release Notes (LTS)](https://docs.flowx.ai/release-notes/v5.x/v5.1.x-lts/v5.1.1-november-2025.md)
- [Accessibility](https://docs.flowx.ai/6.x/docs/platform-deep-dive/accessibility.md)
- [FlowX.AI 5.9.0 Release Notes](https://docs.flowx.ai/release-notes/v5.x/v5.9.0-june-2026/v5.9.0-june-2026.md)
- [FlowX.AI 5.2.0 Release Notes](https://docs.flowx.ai/release-notes/v5.x/v5.2.0-november-2025/v5.2.0-november-2025.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.