Forms and selection · stable · MIT

Toggle Group

Single or multiple pressed choices coordinated as a labelled group.

Install editable source

Add Toggle Group

Base UI / canonicalnpx shadcn@latest add https://gummyui.dev/r/gummy-toggle-group.json

Radix UI counterpartnpx shadcn@latest add https://gummyui.dev/r/gummy-radix-toggle-group.json

Canonical dependency: @base-ui/react. Radix counterpart: @radix-ui/react-toggle-group. Registry dependencies are resolved automatically.

Behavior contract

Base UI group of toggle buttons with orientation.

Tab reaches items; arrows move within the group.

Light and dark themes, logical RTL layout, reduced motion, responsive content, and forwarded public refs.

Source-derived reference

These public React parts are read directly from the canonical source during the documentation build.

Composes GummyToggleProps & { value: string; }

Composes ToggleGroup.Props & { label: string; }

Troubleshooting

If the material is missing, confirm the registry-installed shared and component CSS files are imported once.
If interaction differs, preserve this contract: Tab reaches items; arrows move within the group.
If assistive output differs, preserve this semantic foundation: Base UI group of toggle buttons with orientation.
If dark, RTL, or reduced-motion behavior is missing, verify the nearest theme, direction, and media-query boundaries rather than adding page-local overrides.

Live product source

The Component Lab exercises real source across default, focus, disabled, responsive, dark, reduced-motion, and RTL contexts.

Interactive inspection

Load the real component preview when you are ready to interact with its responsive, theme, and direction controls.

Radix UI counterpart

Load the separately installable Radix counterpart when you are ready to interact with its real behavior.

Editable source

The registry payload stays off the initial page request.

The registry payload stays off the initial page request.