Restrictions and Limitations

2025-07-31

This document describes the usage restrictions of the ZEGO Express SDK Room service, including rate limits, string size limits, etc.

Room

The ZEGO Room service supports millions of users online simultaneously in a single room. By default, the total login QPS for all users in each room is 200, which means a maximum of 200 users can login to the same room per second.

Note

If you need to increase the limit, please contact ZEGOCLOUD Technical Support for evaluation.

In-room Messaging

SDK API	Size Limit	Send Frequency Limit (Within a single room in the SDK)	Description
Send broadcast message sendBroadcastMessage	The default message length limit is 1 KB. To send messages larger than 1 KB, please contact ZEGOCLOUD Technical Support for configuration.	10 times/s	Messages are reliable. The maximum QPS for a single user calling this API on the client is 2.
Send barrage message sendBarrageMessage	The default message length limit is 1 KB. To send messages larger than 1 KB, please contact ZEGOCLOUD Technical Support for configuration.	20 times/s	Messages are not guaranteed to be reliable.
Send custom signaling message sendCustomCommand	The message length cannot exceed 1 KB.	When sending to a single user: 200 messages/s When sending to multiple users: 10 messages/s	Messages are reliable.

Note

Message reliability here refers to whether the remote user can successfully receive the message when the network connection is normal.

Room Extra Info

SDK API	Size Limit	Send Frequency Limit (Within a single room in the SDK)	Description
Set room extra info setRoomExtraInfo	key: The key value for room extra info, cannot exceed 10 B, cannot be an empty string, and only one key type is allowed in a room. value: The content of room extra info, cannot exceed 128 B, can be an empty string.	10 times/s	When a single user calls this API multiple times on the client, please ensure that the callback notification from the previous API call has been successfully received before calling again.