Modifies a participant in a Daily call — muting, ejecting, updating permissions, or controlling track subscriptions.
updateParticipant(sessionId, updates) Prebuilt CustomModifies a participant, either by sending a message to change their state, or by changing how you see them locally. Returns this for chaining.
Parameters
string
required
The participant’s session_id, or 'local' for the local participant.
DailyParticipantUpdateOptions
required
An object describing what to update. All fields are optional.
Hide properties
boolean
Mute (false) or unmute (true) the participant’s microphone. Requires the caller to be a participant admin ('participants' in canAdmin). Silently ignored if not possible or if there is no active meeting.
For the local participant, prefer setLocalAudio() — though both work. For remote participants, admins can mute (false) but only meeting owners can unmute (true), and doing so is strongly discouraged as a privacy concern.
boolean
Enable (true) or disable (false) the participant’s camera. Requires participant admin permission. Silently ignored if not possible.
For the local participant, prefer setLocalVideo() — though both work.
Remotely controlling another participant’s camera or microphone is a potential privacy issue. Use deliberately. Browsers require the user to have explicitly allowed mic/camera access at least once.
false
Stop the participant’s active screen share. Only false is accepted. Requires participant admin permission. Has no effect when sessionId is 'local'.
true
Remove the participant from the call. Only true is accepted. Requires participant admin permission.
DailyTrackSubscriptionOptions
Controls which tracks you receive from this participant. SFU mode only — not supported in Daily Prebuilt. Requires subscribeToTracksAutomatically to be false; throws an error if it is true.Accepts true, false, 'staged', 'avatar', or a per-track object:
true — subscribe: set up a consumer connection and start transmitting data
false — unsubscribe: tear down the consumer connection
'staged' — set up the consumer connection but pause data transmission; no bandwidth cost, but going from 'staged' → true is faster than subscribing from scratch
'avatar' — subscribe to audio only, receive a placeholder for video
When supporting large calls, subscribe to tracks you’re rendering, stage tracks on adjacent pages, and unsubscribe from everything else.
DailyParticipantPermissionsUpdate
Updates the participant’s in-call permissions (canSend, canReceive, hasPresence, canAdmin). Requires the caller to be a participant admin. See DailyParticipantPermissions for the full shape and behavior of each field.