Zoom Developer Forum

How to track participant name changes in breakout rooms

Updated at:
October 16, 2025
Written By:
Aydin Schwartz

Question

People commonly ask on the Zoom Developer Forum:

In the Web Meeting SDK (v3.8.10), a participant’s display name that was renamed by the host reverts to the original join-time name after being moved into a Breakout Room (or when leaving/rejoining one). Native Zoom clients keep the renamed name. Is this a bug, and is there a workaround to preserve the rename across Breakout Room transitions?

Answer

This behavior appears specific to the Web Meeting SDK during Breakout Room transitions (native clients retain the rename), suggesting an SDK-side issue rather than a host policy problem.

Workarounds and next steps:

  1. Test across SDK versions

Try other Web Meeting SDK versions to confirm whether the regression is limited to 3.8.10.

  1. Reapply the rename on room changes
  • In the host/co-host client, listen for room changes via inMeetingServiceListener('onRoomStatusChange', ...).
  • On each move event, immediately call ZoomMtg.rename(...) for the affected userId to reapply the desired display name.
  1. Track the intended display name

Maintain a mapping of userId -> desired display name so you can consistently reapply it on every Breakout Room transition (both into a room and when returning to the main room).


Zoom Developer Forum Examples

Some examples of this question are:

Written By:
Aydin Schwartz