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

# Participant events

> Events for participant state changes — joining, leaving, updates, waiting room, and active speaker.

These events fire when participants join or leave the call, when participant state changes, and when waiting room or active speaker status updates.

***

## participant-joined

Fires when a new remote participant joins the call.

> [!NOTE]
>
> This event may fire for a remote participant before the local [`joined-meeting`](https://docs.daily.co/reference/react-native/events/lifecycle-events#joined-meeting) event fires.

**action** `string`

Always `"participant-joined"`.

**callClientId** `string`

The ID of the call client instance that emitted this event.

**participant** `DailyParticipant`

The participant who joined. See [`DailyParticipant`](https://docs.daily.co/reference/react-native/types/daily-participant) for the full shape.

```json theme={null}
// Example event object
{
  "action": "participant-joined",
  "callClientId": "17225364729060.9442072768918943",
  "participant": {
    "session_id": "6f0ce557-e6e4-409f-bae9-fe5663ba4ae7",
    "user_name": "A. User Name",
    "user_id": "user_123",
    "joined_at": "2023-06-01T18:37:59.946Z",
    "local": false,
    "owner": false,
    "networkQualityState": "unknown",
    "permissions": {
      "hasPresence": true,
      "canSend": true,
      "canReceive": { "base": true },
      "canAdmin": false
    },
    "will_eject_at": "1970-01-01T00:00:00.000Z",
    "tracks": {
      "audio": { "subscribed": false, "state": "sendable" },
      "video": { "subscribed": false, "state": "sendable" },
      "screenVideo": { "subscribed": false, "state": "off", "off": { "byUser": true } },
      "screenAudio": { "subscribed": false, "state": "off", "off": { "byUser": true } }
    },
    "record": false
  }
}
```

```javascript theme={null}
call.on('participant-joined', ({ participant }) => {
  console.log(`${participant.user_name || participant.session_id} joined`);
  addParticipantTile(participant);
});
```

***

## participant-updated

Fires when a local or remote participant's state changes — for example when their audio or video track state changes, their permissions are updated, or their network quality changes.

**action** `string`

Always `"participant-updated"`.

**callClientId** `string`

The ID of the call client instance that emitted this event.

**participant** `DailyParticipant`

The updated participant. See [`DailyParticipant`](https://docs.daily.co/reference/react-native/types/daily-participant) for the full shape.

```json theme={null}
// Example event object
{
  "action": "participant-updated",
  "callClientId": "17225364729060.9442072768918943",
  "participant": {
    "session_id": "6f0ce557-e6e4-409f-bae9-fe5663ba4ae7",
    "..."
  }
}
```

```javascript theme={null}
call.on('participant-updated', ({ participant }) => {
  updateParticipantTile(participant);
});
```

***

## participant-left

Fires when a remote participant leaves the call. The `participant` object reflects the participant's state just before they disconnected.

> [!NOTE]
>
> A participant [losing presence](https://docs.daily.co/reference/react-native/instance-methods/update-participant.md#param-update-permissions) is treated as leaving and triggers this event. In that case, the optional `reason` field will be `'hidden'`.

**action** `string`

Always `"participant-left"`.

**callClientId** `string`

The ID of the call client instance that emitted this event.

**participant** `DailyParticipant`

The participant who left, captured just before they disconnected. See [`DailyParticipant`](https://docs.daily.co/reference/react-native/types/daily-participant) for the full shape.

**reason** `string`

Optional. Present when the participant became hidden rather than truly leaving. Value is `'hidden'`.

```json theme={null}
// Example event object
{
  "action": "participant-left",
  "callClientId": "17225364729060.9442072768918943",
  "participant": {
    "session_id": "6f0ce557-e6e4-409f-bae9-fe5663ba4ae7",
    "..."
  },
  "reason": "hidden"
}
```

```javascript theme={null}
call.on('participant-left', ({ participant }) => {
  removeParticipantTile(participant.session_id);
});
```

***

## participant-counts-updated

Fires when the count of present or hidden participants in the call changes. See [`participantCounts()`](https://docs.daily.co/reference/react-native/instance-methods/participant-counts) for details.

**action** `string`

Always `"participant-counts-updated"`.

**callClientId** `string`

The ID of the call client instance that emitted this event.

**participantCounts** `object`

Contains `present` (number of visible participants) and `hidden` (number of hidden participants).

```json theme={null}
// Example event object
{
  "action": "participant-counts-updated",
  "callClientId": "17225364729060.9442072768918943",
  "participantCounts": {
    "present": 4,
    "hidden": 1
  }
}
```

```javascript theme={null}
call.on('participant-counts-updated', ({ participantCounts }) => {
  document.getElementById('participant-count').textContent = participantCounts.present;
});
```

***

## waiting-participant-added

Fires when a participant enters the waiting room and is added to the [`waitingParticipants()`](https://docs.daily.co/reference/react-native/instance-methods/waiting-participants) set.

**action** `string`

Always `"waiting-participant-added"`.

**callClientId** `string`

The ID of the call client instance that emitted this event.

**participant** `object`

Contains `id`, `name`, and `awaitingAccess` (with a `level` field indicating the requested access level).

```json theme={null}
// Example event object
{
  "action": "waiting-participant-added",
  "callClientId": "17225364729060.9442072768918943",
  "participant": {
    "id": "a64d30f4-5216-4481-a2ef-515d6dd7dfc6",
    "name": "Jane Smith",
    "awaitingAccess": { "level": "full" }
  }
}
```

***

## waiting-participant-updated

Fires when a participant in the waiting room updates their details — currently this only occurs when their `name` changes.

**action** `string`

Always `"waiting-participant-updated"`.

**callClientId** `string`

The ID of the call client instance that emitted this event.

**participant** `object`

Contains `id`, `name`, and `awaitingAccess`.

```json theme={null}
// Example event object
{
  "action": "waiting-participant-updated",
  "callClientId": "17225364729060.9442072768918943",
  "participant": {
    "id": "a64d30f4-5216-4481-a2ef-515d6dd7dfc6",
    "name": "Jane Smith (updated)",
    "awaitingAccess": { "level": "full" }
  }
}
```

***

## waiting-participant-removed

Fires when a participant is removed from the [`waitingParticipants()`](https://docs.daily.co/reference/react-native/instance-methods/waiting-participants) set — either they were granted access, denied, or left on their own.

**action** `string`

Always `"waiting-participant-removed"`.

**callClientId** `string`

The ID of the call client instance that emitted this event.

**participant** `object`

Contains `id`, `name`, and `awaitingAccess`.

```json theme={null}
// Example event object
{
  "action": "waiting-participant-removed",
  "callClientId": "17225364729060.9442072768918943",
  "participant": {
    "id": "a64d30f4-5216-4481-a2ef-515d6dd7dfc6",
    "name": "Jane Smith",
    "awaitingAccess": { "level": "full" }
  }
}
```

***

## active-speaker-change

Fires when the active speaker — the participant whose audio input is currently loudest — changes. Use this to highlight the speaking participant in a custom UI.

**action** `string`

Always `"active-speaker-change"`.

**callClientId** `string`

The ID of the call client instance that emitted this event.

**activeSpeaker** `object`

Contains `peerId`, which is the `session_id` of the participant currently speaking.

```json theme={null}
// Example event object
{
  "action": "active-speaker-change",
  "callClientId": "17225364729060.9442072768918943",
  "activeSpeaker": {
    "peerId": "049ebba2-523b-4e6c-9a9f-1f8bb956670d"
  }
}
```

```javascript theme={null}
call.on('active-speaker-change', ({ activeSpeaker }) => {
  highlightSpeaker(activeSpeaker.peerId);
});
```

***

## See also

> [card] Types
>
> * [DailyParticipant](https://docs.daily.co/reference/react-native/types/daily-participant.md)

> [card] Methods
>
> * [participants()](https://docs.daily.co/reference/react-native/instance-methods/participants.md)
> * [participantCounts()](https://docs.daily.co/reference/react-native/instance-methods/participant-counts.md)
> * [updateParticipant()](https://docs.daily.co/reference/react-native/instance-methods/update-participant.md)
> * [waitingParticipants()](https://docs.daily.co/reference/react-native/instance-methods/waiting-participants.md)

> [card] Events
>
> * [Lifecycle events](https://docs.daily.co/reference/react-native/events/lifecycle-events.md)

> [card] Guides
>
> * [Participants](https://docs.daily.co/docs/daily-js/concepts/participants.md)
> * [Waiting room](https://docs.daily.co/docs/daily-js/guides/waiting-room.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.