> ## Documentation Index
> Fetch the complete documentation index at: https://www.cometchat.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Participant Management

> CometChat Calling SDK v5 - Participant Management for JavaScript

Manage call participants including muting, pinning, and monitoring their status during a call.

## Participant Actions

### Mute Participant

Mute a specific participant's audio. This is typically a moderator action.

```javascript theme={null}
CometChatCalls.muteParticipant(participantId);
```

| Parameter       | Type   | Description                         |
| --------------- | ------ | ----------------------------------- |
| `participantId` | String | The participant's unique identifier |

### Pause Participant Video

Pause a specific participant's video. This is typically a moderator action.

```javascript theme={null}
CometChatCalls.pauseParticipantVideo(participantId);
```

| Parameter       | Type   | Description                         |
| --------------- | ------ | ----------------------------------- |
| `participantId` | String | The participant's unique identifier |

### Pin Participant

Pin a participant to keep them prominently displayed regardless of who is speaking.

```javascript theme={null}
CometChatCalls.pinParticipant(participantId, type);
```

| Parameter       | Type   | Description                         |
| --------------- | ------ | ----------------------------------- |
| `participantId` | String | The participant's unique identifier |
| `type`          | String | The participant type                |

### Unpin Participant

Remove the pin, returning to automatic speaker highlighting.

```javascript theme={null}
CometChatCalls.unpinParticipant();
```

## Participant Events

### Participant Joined

Fired when a participant joins the call:

```javascript theme={null}
CometChatCalls.addEventListener("onParticipantJoined", (participant) => {
  console.log(`${participant.name} joined the call`);
});
```

### Participant Left

Fired when a participant leaves the call:

```javascript theme={null}
CometChatCalls.addEventListener("onParticipantLeft", (participant) => {
  console.log(`${participant.name} left the call`);
});
```

### Participant List Changed

Fired when the participant list is updated:

```javascript theme={null}
CometChatCalls.addEventListener("onParticipantListChanged", (participants) => {
  console.log(`Total participants: ${participants.length}`);
  participants.forEach(p => console.log(p.name));
});
```

### Participant Audio State

Monitor when participants mute or unmute:

```javascript theme={null}
CometChatCalls.addEventListener("onParticipantAudioMuted", (participant) => {
  console.log(`${participant.name} muted their audio`);
});

CometChatCalls.addEventListener("onParticipantAudioUnmuted", (participant) => {
  console.log(`${participant.name} unmuted their audio`);
});
```

### Participant Video State

Monitor when participants turn their camera on or off:

```javascript theme={null}
CometChatCalls.addEventListener("onParticipantVideoPaused", (participant) => {
  console.log(`${participant.name} turned off their camera`);
});

CometChatCalls.addEventListener("onParticipantVideoResumed", (participant) => {
  console.log(`${participant.name} turned on their camera`);
});
```

### Dominant Speaker Changed

Fired when the active speaker changes:

```javascript theme={null}
CometChatCalls.addEventListener("onDominantSpeakerChanged", (participant) => {
  console.log(`Active speaker: ${participant.name}`);
});
```

## Participant List UI

### Show/Hide Participant List Button

Control visibility of the participant list button:

```javascript theme={null}
const callSettings = {
  hideParticipantListButton: false, // Show the button
  // ... other settings
};
```

### Listen for Participant List Events

Monitor when the participant list panel is opened or closed:

```javascript theme={null}
CometChatCalls.addEventListener("onParticipantListVisible", () => {
  console.log("Participant list opened");
});

CometChatCalls.addEventListener("onParticipantListHidden", () => {
  console.log("Participant list closed");
});
```

### Listen for Participant List Button Clicks

Intercept participant list button clicks:

```javascript theme={null}
CometChatCalls.addEventListener("onParticipantListButtonClicked", () => {
  console.log("Participant list button clicked");
});
```

## Participant Object

| Property | Type   | Description                           |
| -------- | ------ | ------------------------------------- |
| `uid`    | String | Unique identifier (CometChat user ID) |
| `name`   | String | Display name                          |
| `avatar` | String | URL of avatar image                   |