Presence
Presence shows who else is currently looking at or editing the same document. It does not merge their edits (that’s a different feature — check with your developers on whether realtime co-editing is enabled), but it tells you when someone else is in the room.
Where you’ll see it
- Top bar — a stack of avatars for every peer currently on the document.
- Block outlines — a colored ring around a block another peer has selected or is editing.
- Field indicators — a small avatar next to a field label shows who’s focused on it.
Each peer has a stable color that matches across all three places.
Your own avatar
You appear in the peer list with your identity (name, avatar URL) as configured by your app. If you’re showing up with a generic “You” label, your developers need to pass an explicit identity to the editor.
Limitations
- Presence is informational. Two people editing the same field will have their edits overwrite each other depending on save order.
- When the other person closes the tab or loses connection, their avatar fades out after a short grace period.
- If your app uses BroadcastChannel (same-origin) for presence, it won’t work across separate browser profiles or domains. For a robust cross-user setup, presence should be wired up through a realtime transport (WebSocket, SSE). See Real-time bindings.
Last updated on