I        This condition is triggered when a peer changes their name while sharing a channel that your client is on.

The channel and peer are auto-selected, so you can read their details using the Selected channel expressions, or the Selected channel > Selected peer expressions.

The Selected channel > Selected peer > Previous name (for on peer name changed) expression will have their previous name, useful if you have UI to modify.

For more details, read the "Maintain a peer list" example.

Peer name change notes

If you share multiple channels with the peer, you will get a Peer Name Changed event for every shared channel.

You will not be notified for a peer's name changes without a shared channel; but note that while a peer can change their name without notifying other clients, they cannot have their ID changed without disconnecting from and reconnecting to the server.


There is no way to see the name before the previous one.

So if a peer changes their name from "a" to "b" to "c" while sharing a channel, during the last event, the previous name expression will show "b", and the current name expression will show "c", with no way to see "a".


It's also worth noting that the previous name is stored with the peer, and peers are stored on a per-channel basis.

So if you are sharing channel "Apple", and a peer renames from "a" to "b", then you both join channel "Bacon", the previous name expression for the same peer will be an unchanged "" in Bacon, but will be "a" in Apple.

Similarly, you won't know the previous name (or that it has changed at all) if you connect to the server after the peer has changed their name.