Skip to main content

State synchronization overview

An overview of state synchronization components for LiveKit.

Overview

LiveKit includes multiple methods for synchronizing state within a room. Use participant attributes and room metadata to manage online status, user preferences, room configuration, and shared settings.

State synchronization components

Synchronize participant-level and room-level state across all participants in a room.

ComponentDescriptionUse cases
Participant attributesA key-value store for every participant that can be used for managing online status, user preferences, and more.Online status indicators, user preferences, participant metadata, and per-participant configuration.
Room metadataA freeform string for room-wide state, ideal for room configuration and shared settings.Room configuration, shared settings, game state, and room-level data that applies to all participants.

In this section

Learn how to manage state synchronization.