LiveKit docs › Components › Media controls › AgentTrackToggle

---

# Agent Track Toggle

> A UI toggle for capturing a client's media input (microphone, camera, screen share).

## Usage

**[AgentTrackToggle](https://docs.livekit.io/reference/components/agents-ui/component/agent-track-toggle.md)** preview:

```tsx
'use client';

import { useSession } from '@livekit/components-react';
import { AgentSessionProvider } from '@/components/agents-ui/agent-session-provider';
import { AgentTrackToggle } from '@/components/agents-ui/agent-track-toggle';

const TOKEN_SOURCE = TokenSource.endpoint('/api/token');
  
export function Demo() {
  const session = useSession(TOKEN_SOURCE);
  const handlePressedChange = (pressed: boolean) => console.log('pressed', pressed);

  return (
    <AgentSessionProvider session={session}>
      <AgentTrackToggle
        variant={{variant}}
        source={{source}}
        pressed={{pressed}}
        pending={{pending}}
        disabled={{disabled}}
        onPressedChange={handlePressedChange}
      />
    </AgentSessionProvider>
  );
}
```

## Features

- Toggle the capture of a client's media input (microphone, camera, screen share)
- Select from five sizes: `icon`, `sm`, `md`, `lg`, and `xl`
- Select from three styles: `default`, `outline`, and `livekit`

## Installation

```bash
pnpm dlx shadcn@latest add @agents-ui/agent-track-toggle

```

## Props

| Prop name | Type | Default |
| --------- | ---- | ------- |
| `size?` | enum | `default` |
| `variant?` | enum | `default` |
| `ref?` | Ref<HTMLButtonElement> | – |
| `source` | enum | – |
| `pending?` | boolean | – |
| `pressed?` | boolean | – |
| `defaultPressed?` | boolean | – |
| `onPressedChange?` | (pressed: boolean) => void | – |
| `...props?` | ComponentProps<'button'> | |

---

This document was rendered at 2026-06-07T11:34:13.006Z.
For the latest version of this document, see [https://docs.livekit.io/reference/components/agents-ui/component/agent-track-toggle.md](https://docs.livekit.io/reference/components/agents-ui/component/agent-track-toggle.md).

To explore all LiveKit documentation, see [llms.txt](https://docs.livekit.io/llms.txt).