LiveKit docs › Components › MediaDeviceMenu

---

# MediaDeviceMenu

The `MediaDeviceMenu` component is a button that opens a menu that lists all media devices and allows the user to select them.

## Import

```typescript
import { MediaDeviceMenu } from "@livekit/components-react";

```

## Remarks

This component is implemented with the `MediaDeviceSelect` LiveKit components.

## Usage

```tsx
<LiveKitRoom>
  <MediaDeviceMenu />
</LiveKitRoom>

```

## Properties

- **`initialSelection`** _(string)_ (optional): _(Optional)_

- **`kind`** _(MediaDeviceKind)_ (optional): _(Optional)_

- **`onActiveDeviceChange`** _((kind: MediaDeviceKind, deviceId: string) => void)_ (optional): _(Optional)_

- **`requestPermissions`** _(boolean)_ (optional): _(Optional)_ this will call getUserMedia if the permissions are not yet given to enumerate the devices with device labels. in some browsers multiple calls to getUserMedia result in multiple permission prompts. It's generally advised only flip this to true, once a (preview) track has been acquired successfully with the appropriate permissions.

- **`tracks`** _(Partial<Record<MediaDeviceKind, LocalAudioTrack | LocalVideoTrack | undefined>>)_ (optional): _(Optional)_

---

This document was rendered at 2026-06-07T11:34:12.156Z.
For the latest version of this document, see [https://docs.livekit.io/reference/components/react/component/mediadevicemenu.md](https://docs.livekit.io/reference/components/react/component/mediadevicemenu.md).

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