Title: ToggleGroupControlOption
Published: October 14, 2021
Last modified: October 14, 2026

---

# ToggleGroupControlOption

## In this article

 * [Usage](https://developer.wordpress.org/block-editor/reference-guides/components/toggle-group-control-option/?output_format=md#usage)
 * [Props](https://developer.wordpress.org/block-editor/reference-guides/components/toggle-group-control-option/?output_format=md#props)
    - [label: string](https://developer.wordpress.org/block-editor/reference-guides/components/toggle-group-control-option/?output_format=md#label-string)
    - [value: string | number](https://developer.wordpress.org/block-editor/reference-guides/components/toggle-group-control-option/?output_format=md#value-string-number)
    - [showTooltip: boolean](https://developer.wordpress.org/block-editor/reference-guides/components/toggle-group-control-option/?output_format=md#showtooltip-boolean)
    - [disabled: boolean](https://developer.wordpress.org/block-editor/reference-guides/components/toggle-group-control-option/?output_format=md#disabled-boolean)

This feature is still experimental. “Experimental” means this is an early implementation
subject to drastic and breaking changes.

`ToggleGroupControlOption` is a form component and is meant to be used as a child
of [`ToggleGroupControl`](https://developer.wordpress.org/block-editor/reference-guide/components/toggle-group-control/toggle-group-control/).

## 󠀁[Usage](https://developer.wordpress.org/block-editor/reference-guides/components/toggle-group-control-option/?output_format=md#usage)󠁿

    ```javascript
    import {
        __experimentalToggleGroupControl as ToggleGroupControl,
        __experimentalToggleGroupControlOption as ToggleGroupControlOption,
    } from '@wordpress/components';

    function Example() {
        return (
            <ToggleGroupControl label="my label" value="vertical" isBlock>
                <ToggleGroupControlOption
                    value="horizontal"
                    label="Horizontal"
                    showTooltip={ true }
                />
                <ToggleGroupControlOption value="vertical" label="Vertical" />
            </ToggleGroupControl>
        );
    }
    ```

## 󠀁[Props](https://developer.wordpress.org/block-editor/reference-guides/components/toggle-group-control-option/?output_format=md#props)󠁿

### 󠀁[label: string](https://developer.wordpress.org/block-editor/reference-guides/components/toggle-group-control-option/?output_format=md#label-string)󠁿

Label for the option. If needed, the `aria-label` prop can be used in addition to
specify a different label for assistive technologies.

 * Required: Yes

### 󠀁[value: string | number](https://developer.wordpress.org/block-editor/reference-guides/components/toggle-group-control-option/?output_format=md#value-string-number)󠁿

The value of the `ToggleGroupControlOption`.

 * Required: Yes

### 󠀁[showTooltip: boolean](https://developer.wordpress.org/block-editor/reference-guides/components/toggle-group-control-option/?output_format=md#showtooltip-boolean)󠁿

Whether to show a tooltip when hovering over the option. The tooltip will attempt
to use the `aria-label` prop text first, then the `label` prop text if no `aria-
label` prop is found.

 * Required: No

### 󠀁[disabled: boolean](https://developer.wordpress.org/block-editor/reference-guides/components/toggle-group-control-option/?output_format=md#disabled-boolean)󠁿

If true, this option is unselectable.

 * Required: No
 * Default: `false`

First published

October 14, 2021

Last updated

October 14, 2026

Edit article

[ Improve it on GitHub: ToggleGroupControlOption ](https://github.com/WordPress/gutenberg/edit/trunk/packages/components/src/toggle-group-control/toggle-group-control-option/README.md)

[  Previous: ToggleGroupControlOptionIcon](https://developer.wordpress.org/block-editor/reference-guides/components/toggle-group-control-option-icon/)

[  Next: ToggleGroupControl](https://developer.wordpress.org/block-editor/reference-guides/components/toggle-group-control/)