# Toggle Group

> A set of toggles where one or several can be active.

_Updated: 2026-06-04_

A set of toggles where one or several can be active.

## Installation

```bash
railbase ui add toggle-group
```

Peer dependencies:

```bash
npm install class-variance-authority
```

> [!NOTE]
> `railbase ui add` also copies the `toggle` component and shared primitives — they ship alongside this component automatically.

## Usage

```tsx
import { ToggleGroup, ToggleGroupItem } from "@/lib/ui/toggle-group";

<ToggleGroup type="single">
  <ToggleGroupItem value="left">Left</ToggleGroupItem>
  <ToggleGroupItem value="center">Center</ToggleGroupItem>
  <ToggleGroupItem value="right">Right</ToggleGroupItem>
</ToggleGroup>
```

## Anatomy

Exported parts: `ToggleGroup` · `ToggleGroupItem`