

<InteractiveDemo name="group" controls="[&#x22;orientation&#x22;, &#x22;isDisabled&#x22;, &#x22;isInvalid&#x22;, &#x22;isReadOnly&#x22;]" />

## Installation [#installation]

<InstallPrerequisite>
  Before adding components, init your project with your design system from the [Studio](/studio).
</InstallPrerequisite>

<CodeBlockTabs defaultValue="npm" groupId="package-manager">
  <CodeBlockTabsList>
    <CodeBlockTabsTrigger value="npm">
      npm
    </CodeBlockTabsTrigger>

    <CodeBlockTabsTrigger value="pnpm">
      pnpm
    </CodeBlockTabsTrigger>

    <CodeBlockTabsTrigger value="yarn">
      yarn
    </CodeBlockTabsTrigger>

    <CodeBlockTabsTrigger value="bun">
      bun
    </CodeBlockTabsTrigger>
  </CodeBlockTabsList>

  <CodeBlockTab value="npm">
    ```bash
    npx shadcn@latest add @dotui/group
    ```
  </CodeBlockTab>

  <CodeBlockTab value="pnpm">
    ```bash
    pnpm dlx shadcn@latest add @dotui/group
    ```
  </CodeBlockTab>

  <CodeBlockTab value="yarn">
    ```bash
    yarn dlx shadcn@latest add @dotui/group
    ```
  </CodeBlockTab>

  <CodeBlockTab value="bun">
    ```bash
    bunx shadcn@latest add @dotui/group
    ```
  </CodeBlockTab>
</CodeBlockTabs>

## Usage [#usage]

```tsx
import { Button } from "@/components/ui/button"
import { Group } from "@/components/ui/group"
```

```tsx
<Group>
  <Button>One</Button>
  <Button>Two</Button>
</Group>
```

## Anatomy [#anatomy]

`Group` is the container; `GroupText` renders an inline text segment between controls (prefixes, suffixes, labels).

```tsx
import { Button } from "@/components/ui/button"
import { Group, GroupText } from "@/components/ui/group"
```

```tsx
<Group>
  <GroupText>Label</GroupText>
  <Button>Action</Button>
</Group>
```

Set `orientation` to `"vertical"` to stack children instead of the default `"horizontal"` row.

`isDisabled`, `isInvalid` and `isReadOnly` set data attributes on the group for styling; they don't reach the controls inside, so pass them to those controls too.

## Examples [#examples]

<Examples className="sm:grid-cols-2 lg:grid-cols-3">
  <Example name="group/demos/basic" title="Basic Group" />

  <Example name="group/demos/navigation" title="Navigation Controls" />

  <Example name="group/demos/nested" title="Chat Interface" />

  <Example name="group/demos/pagination" title="Pagination" className="col-span-full" />

  <Example name="group/demos/vertical-nested" title="Design Tools Palette" />

  <Example name="group/demos/with-dropdown" title="Split Button with Dropdown" />

  <Example name="group/demos/with-fields" title="Numeric Field with Controls" />

  <Example name="group/demos/with-like" title="Like Button" />

  <Example name="group/demos/with-select-and-input" title="Amount Transfer Form" />

  <Example name="group/demos/with-select" title="Duration Selector" />
</Examples>

## API Reference [#api-reference]

<Reference name="group" />
